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SECTION 2 
FORTRAN PROGRAM FORM 



8080 FORTRAN source programs consist of one program unit 
called the Main program and any number of program units 
called subprograms . A discussion of subprogram types and 
methods of writing and using them is in Section 9 of this 
manual . 

Programs and program units are constructed of an ordered set 
of statements which precisely describe procedures for 
solving problems and which also define information to be 
used by the FORTRAN processor during compilation of the 
object program. Each statement is written using the FORTRAN 
character set and following a prescribed line format. 



2.1 FORTRAN CHARACTER SET 

To simplify reference and explanation, the FORTRAN 
character set is divided into four subsets and a 
name is given to each. 

2.1.1 LETTERS 

A,B,C,D,E,F,G,H,I,J,K,L,M,N,0,P,Q,R,S,T,U 
V,W,X,Y,Z,$ 



NOTE 

No distinction is made between upper and 
lower case letters. However, for clarity 
and legibility, exclusive use of upper case 
1-fi'^fc' letters is recommended. 









2.1.2 ^DIGITS 



0,1,2,3,4,5,6,7,8,9 



NOTE 



( 



Strings of digits representing numeric 
quantities are normally interpreted as 
decimal numbers. However, in certain 
statements, the interpretation is in the 
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Hexadecimal number system in which case the 
letters A, B, C, D, E, F may also be used 
as Hexadecimal digits. Hexadecimal usage 
is defined in the descriptions of 
statements in which such notation is 
allowed. 



2.1.3 ALPHANUMERICS 

A sub-set of characters made up of all letters and 
all digits. 

2.1.4 SPECIAL CHARACTERS 

Blank 
= Equality Sign 
+ Plus Sign 

Minus Sign 
* Asterisk 
/ Slash 
( Left Parenthesis 
) Right Parenthesis 
, Comma 

Decimal Point 

NOTES : 



1 . FORTRAN program lines consist of 80 character 
positions or columns, numbered 1 through 80. 
They are divided into four fields. 

2. The following special characters are classified 
as Arithmetic Operators and are significant in 
the unambiguous statement of arithmetic 
expressions . 

+ Addition or Positive Value 

- Subtraction or Negative VAlue 

* Multiplication 

/ Division 

** Exponentiation 



3. The other special characters have specific 

application in the syntactical expression of 

the FORTRAN language and in the construction of 
FORTRAN statements. 
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4. Any printable character may appear in 
Hollerith or Literal field. 



2.2 FORTRAN LINE FORMAT 

The sample FORTRAN coding form (Figure 2.1) shows 
the format of FORTRAN program lines. The lines of 
the form consist of 80 character positions or 
columns, numbered 1 through 80, and are divided 
into four fields. 

1. Statement Label (or Number) field- Columns 1 
through 5 (See definition of statement labels). 

2. Continuation character field- 
Column 6 

3. Statement field- 
Columns 7 through 72 

4. Indentification field- 
Columns 7 3 through 80 

The identification field is available for any 
purpose the FORTRAN programmer may desire and is 
ignored by the FORTRAN processor. 

The lines of a FORTRAN statement are placed in 
Columns 1 through 72 formatted according to line 
types. The four line types, their definitions, and 
column formats are: 

1. Comment line — used for source program 



annotation 
programmer. 



at the convenience of the 



C 



1 . Column 1 contains the letter C. 

2. Columns 2-72 are used in any desired 
format to express the comment or they may 
be left blank. 

3. A comment line may be followed only by an 
initial line, an END line, or another 
comment line. 

4. Comment lines have no effect on the object 
program and are ignored by the FORTRAN 
processor except for display purposes in 
the listing of the program. 
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Example: 



C COMMENT LINES ARE INDICATED BY THE 
C CHARACTER C IN COLUMN 1 . 
C THESE ARE COMMENT LINES 



END line — the last line of a program unit. 

1. Columns 1-5 may contain a statement label. 

2. Column 6 must contain a zero or blank. 

3. Columns 7-72 contain one of the characters 
E, N or D, in that order, preceded by, 
separated by or followed by blank 

characters. 

4. Each FORTRAN program unit must have an END 
line as its last line to inform the 
Processor that it is at the physical end of 
the program unit. 

5. An END line may follow any other type line. 

Example: 
END 



3. Initial Line — the first or only line of each 

statement. 

1. Columns 1-5 may contain a statement label 
to identify the statement. 

2. Column 6 must contain a zero or blank. 

3. Columns 7-72 contain all or part of the 

statement. 

4. An initial line may begin anywhere within 
the statement field. 

Example : 

C THE STATEMENT BELOW CONSISTS 

C OF AN INITIAL LINE 

C 

A= .5*SQRT(3-2.*C) 
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4. Continuation Line — used when additional lines 
of coding are required to complete a statement 
originating with an initial line. 

1. Columns 1-5 are ignored, unless Column 1 
contains a C. 

2. If Column 1 contains a C, it is a comment 
line. 

3. Column 6 must contain a character other 
than zero or blank. 

4. Columns 7-72 contain the continuation of 
the statement. 

5. There may be as many continuation lines as 
needed to complete the statement. 



Example ; 

C THE STATEMENTS BELOW ARE AN INITIAL LINE 

C AND 2 CONTINUATION LINES 

C 

6 3 BETA (1,2) = 

1 A6BAR**7-(BETA(2,2)-A5BAR*50 

2 +SQRT (BETA(2,1))) 



A statement label may be placed in columns 1-5 of a 
FORTRAN statement initial line and is used for 
reference purposes in other statements. 



The following considerations govern the use of 
statement labels: 

1. The label is an integer from 1 to 99999. 

2. The numeric value of the label, leading zeros 
and blanks are not significant. 

3. A label must be unique within a program unit. 

4. A label on a continuation line is ignored by 
the FORTRAN Processor. 
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Example; 

C EXAMPLES OF STATEMENT LABELS 

C 

1 

1 01 
99999 
763 



2 . 3 STATEMENTS 



Individual statements deal with specific aspects of 
a procedure described in a program unit and are 
classified as either executable or non-executable. 

utable statements specify actions and cause the 



Exec 



Processor to generate object progr 



am 



FORTRAN - 

tructions.' There are three types of executable 



xns 
statements 



1. Replacement statements. 

2. Control statements. 

3. Input/Output statements. 

Non-exec utable statements describe to the processor 
the— nature and arrangement of data and Provide 
information about input/output formats and data 
initialization to the object program during Program 
loading and execution. There are five types ot 
non-executable statements: 

1. Specification statements. 

2. DATA Initialization statements. 

3. FORMAT statements. 

4. FUNCTION defining statements. 

5. Subprogram statements. 

The proper usage and construction of the various 
types of statements are described m Sections 5 
through 9. 
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SECTION 3 
DATA REPRESENTATION / STORAGE FORMAT 

The FORTRAN Language prescribes a definitive method for 
identifying data used in FORTRAN programs by name and tyjoe. 

3.1 DATA NAMES AND TYPES 

3.1.1 NAMES 

1. Constant - An explicitly stated datum. 

2. Variable - A symbolically identified datum. 

3. Array - An ordered set of data in 1 , 2 or 3 
dimensions . 

4. Array Element - One member of the set of data 
of an array. 

3.1.2 TYPES 

1 Inteqer — Precise representation of integral 
1 ' number! (positive, negative or zero) having 

precision to 5 digits in the range -32768 to +32767 

inclusive (-2**15 to 2**15-1). 



2 Real — Approximations of real numbers (positive, 
2 ' native P or zero) represented in computer storage 

in 4-byte, floating-point form Real data are 
nrecise to 7+ significant digits and their 
SgniLde may lie between the approximate limits of 
10**-38 and 10**38 (2**-127 and 2**127). 

3 Double Precision -- Approximations of real ^rubers 

(positive, negative or zero) represented in 
computer storage in 8-byte, floating-point form 
Double Precision data are Precise to 16+ 
significant digits in the same magnitude range as 
real data. 

4. Logical - One byte representations of ^in^to" 
values "TRUE" or "FALSE" with "FALSE defined to 
l,,, p an internal representation of zero. ine 
cSnstaS %™ has" the value "1- J-ver any < J 
non-zero value will be treated as .TRUE. in a 
Sooical IF statement. In addition, Logical types 
may be used as one byte signed integers m the 
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range -128 to +127, inclusive. 

Hollerith — A string of any number of characters 
from the computer ' s character set. All characters 
including blanks are significant. Hollerith data 
require one byte for storage of each character in 

the string. 



3.2 CONSTANTS 

FORTRAN constants are identified explicitly by 
stating their actual value. The plus (+) character 
need not precede positive valued constants. 

Formats for writing constants are shown in Table 
3-1. 
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Table 3-1. CONSTANT FORMATS 



TYPE FORMATS AND RULES OF USE EXAMPLES 



INTEGER 1. 1 to 5 decimal digits -763 

interpreted as a deci- 1 
mal number. +00672 

2. A preceding plus (+) or -32768 
minus (.-) sign is op- +32767 
tional. 

3. No decimal point (.) or 
comma (,) is allowed. 

4. Value range: -32768 
through +32767 (.i.e., 
-2**15 through 2**15-1). 



REAL 1. A decimal number with 345. 

precision to 7 digits -.345678 

and represented in one +345.678 

of the following forms: +.3E3 



-73E4 



a. + or -.f + or -i.f 

b. + or -i.E+ or -e 
+ or -.fE+ or -e 
+ or -i.fE+ or -e 



where i, f, and e are 
each strings represent- 
ing integer, fraction, 
and exponent respective- 
ly. 

2. Plus (+) and minus (-) 
characters are optional. 

3. In the form shown in 1 b 
above, if r represents any 
of the forms preceding 

E+ or -e (i.e., rE+ or -e) , 
the value of the constant 
is interpreted as r times 
10**e, where -38<=e<=38. 

4. If the constant preceding 
E+ or -e contains more 
significant digits than 
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the precision for real 
data allows, truncation 
occurs, and only the 
most significant digits 
in the range will be rep- 
resented. 



DOUBLE 
PRECISION 



A decimal number with 
precision to 16 digits. All- 
formats and rules are identi- 
cal to those for REAL con- 
stants, except D is used in 
place of E. Note that a real 
constant is assumed single pre- 
cision unless it contains a 
"D" exponent. 



+345.678 
+ .3D3 
-73D4 



LOGICAL 



.TRUE, generates a non-zero 
byte (hexadecimal FF) and 
.FALSE, generates a byte in 
which all bits are 0. 



, TRUE . 
, FALSE . 



If logical values are 
used as one-byte integers, the 
rules for use are the same as 
for type INTEGER, except that 
the range allowed is -128 to 
+127, inclusive. 



LITERAL 



In the literal form, any 
number of characters may be 
enclosed by single quotation 
marks. The form is as follows: 



'X1X2X3. . .Xn' 

where each Xi is any charac- 
ter other than ' . Two 
quotation marks in succession 
may be used to represent the 
quotation mark character 
within the string, i.e., 
if X2 is to be the quotation 
mark character, the string 
appears as the following: 

•X1 ' 'X3. . .Xn' 



HEXADECIMAL 



1 . The letter Z or X 
followed by a single quote, 
up to 4 hexadecimal 



Z ' 12 ' 

X'ABIF' 
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digits (0-9 and A-F) and a Z'FFFF* 

single quote is recognized 

as a hexadecimal value. X'1F' 

2. A hexadecimal constant is 
right justified in its storage 
value. 
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3.3 



VARIABLES 

Variable data are identified in FORTRAN- statements 
b Y symbolic names. The names are unique strings of 
from 1 to 6 alphanumeric characters 
first is a letter. 



of which the 



NOTE 

System variable names and runtime 
subprogram names are distinguished from 
other variable names in that they begin 
with the dollar sign character ($). It is 
therefore strongly recommended that in 
order to avoid conflicts, symbolic names in 
FORTRAN source programs begin with some 
letter other than "$". 



Examples : 

15, TBAR, B23, ARRAY, XFM79 , MAX, A1$C 



Variable data are classified into four types: 

INTEGER, REAL, DOUBLE PRECISION and LOGICAL. The 

specification of type is accomplished in one of the 
following ways: 



1. 



Implicit typing in which the first letter of 
the symbolic name specifies Integer or Real 
type. Unless explicitly typed (2., below), 
symbolic names beginning with I, J, K, L, M or 
N represent Integer variables, and symbolic 
names beginning with letters other than I, J, 
K, L, M or N represent Real variables. 

Integer Variables 



ITEM 

J1 

MODE 

K123 

N2 
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Real Variables 

BETA 

H2 

ZAP 

AMAT 

XID 



2. Variables may be typed explicitly. That is, 
they may be given a particular type without 
reference to the first letters of their names. 
Variables may be explicitly typed as INTEGER, 
REAL, DOUBLE PRECISION or LOGICAL. The 
specific statements used in explicitly typing 
data are described in Section 6. 



Variable data receive their numeric value assignments during 
program execution or, initially, in a DATA statement 
(Section 6) . 

Hollerith or Literal data may be assigned to any type 
variable. Sub-paragraph 3.6 contains a discussion of 
Hollerith data storage. 



3.4 ARRAYS AND ARRAY ELEMENTS 

An array is an ordered set of data characterized by 
the property of dime nsion. An array may have 1 , 2 
or 3 dimensions and~Ts identified and typed by a 
symbolic name in the same manner as a variable 
except that an array name must be so declared by an 
"array declarator." Complete discussions of the 
array declarators appear in Section 6 of this 
manual. An array declarator also indicates the 
dimensionality and size of the array. An array 
element is one member of the data set that makes up 
an array. Reference to an array element in a 
FORTRAN statement is made by appending a subscript 
to the array name. The term array element is 
synonymous with the term subscripted variable used 
in some FORTRAN texts and reference manuals. 

An initial value may be assigned to any array 
element by a DATA statement or its value may be 
derived and defined during program execution. 



3 . 5 SU BSCRIP TS 

A subscript follows an array name to uniquely 
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identify an array element. In use, a subscript in 
a FORTRAN statement takes on the _ same 
representational meaning as a subscript in familiar 
algebraic notation. 

Rules that govern the use of subscripts are as 
follows : 

1. A subscript contains 1 , 2 or 3 subscript 
expressions (see 4 below) enclosed in 
parentheses. 

2. If there are two or three subscript expressions 
within the parentheses, they must be separated 
by commas . 

3. The number of subscript expressions must be the 
same as the specified dimensionality of the 
Array Declarator except in EQUIVALENCE 
statements (Section 6). 

4. A subscript expression is written in one of the 
following forms: 

K C*V V-K 
V C*V+K C*V-K 
V+K 

where C and K are integer constants and V is an 
integer variable name (see Section 4 for a 
discussion of expression evaluation) . 

5. Subscripts themselves may not be subscripted. 
Examples : 

X(2*J-3,7) A(I,J,K) 1(20) C(L-2) Y(I) 



3.6 DATA STORAGE ALLOCATION 

Allocation of storage for FORTRAN data is made in 
numbers of storage units . A storage unit is the 
memory space required to store one real data value 
(4 bytes) . 

Table 3-2 defines the word formats of the three 
data types. 

Hexadecimal data may be associated (via a DATA 
statement) with any type data. Its storage 
allocation is the same as the associated datum. 

Hollerith or literal data may be associated with 
any data type by use of DATA initializaton 
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statements (Section 6) . 

Up to eight Hollerith characters may be associated 
with Double Precision type storage, up to four with 
Real, up to two with Integer and one with Logical 
type storage. 



. --mm-. . 
, • * - *■< 



I | 
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TABLE 3-2 



STORAGE ALLOCATION BY DATA TYPES 



TYPE 



INTEGER 



LOGICAL 



ALLOCATION 

2 bytes/ 1/2 storage unit 

S Binary Value 

Negative numbers are the 2's complement of 
positive representations. 

1 byte/ 1/4 storage unit 

Zero (false) or non-zero (true) 

A non-zero valued byte indicates true (the 
logical constant .TRUE. is represented by 
the hexadecimal value FF) . A zero valued 
byte indicates false. 

When used as an arithmetic value, a Logical 
datum is treated as an Integer in the range 
-128 to +127. 



REAL 



4 bytes/ 1 storage unit 



Characteristic 
Mantissa 



S Mantissa 
(continued) 



The first byte is the characteristic 
expressed in excess 200 (octal) notation; 
i.e., a value of 200 (octal) corresponds to a 
binary exponent of 0. Values less than 200 
(octal) correspond to negative exponents, and 
values greater than 200 correspond to 
positive exponents. By definition, if the 
characteristic is zero, the entire number is 
zero. 



( 



The next thre 
The mantissa 
the high orde 
need to actua 
is used inste 
number. A 
and zero indi 
mantissa is 
whose binary 
mantissa. 



e bytes constitute 
is always normal 
r bit is one, el 
lly save that bit. 
ad to indicate the 
one indicates a ne 
cates a positive 

assumed to be a b 
point is to the 



the mantissa. 

ized such that 

iminating the 

The high bit 

sign of the 
gative number, 

number. The 
ii.ary fraction 

left of the 
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DOUBLE 8 bytes/ 2 storage units 

PRECISION 

The internal form of Double Precision data is 
identical with that of Real data except 
Double Precision uses 4 extra bytes for the 
matissa. 
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SECTION 4 
FORTRAN EXPRESSIONS 



A FORTRAN expression is composed of a single operand or a 
string of operands connected by operators. Two expression 
types —Arithmetic and Logical— are provided by F0 ^RAN. 
Tne operands, operators and rules of use for both types are 
described in the following paragraphs. 

4 . 1 ARITHMETIC EXPRESSIONS 

The following rules define all permissible 
arithmetic expression forms: 

1. A constant, variable name, array element 
reference or FUNCTION reference (Section 9) 
standing alone is an expression. 

Examples: 

S(I) JOBNO 217 17.26 SQRT(A+B) 

2 If E is an expression whose first character is 
not an operator, then +E and -E are called 
signed expressions. 

Examples 

-S +JOBNO -217 +17.26 -SQRT(A+B) 

3. If E is an expression, then (E) means the 
quantity resulting when E is evaluated. 

Examples: 
(_ A ) -(JOBNO) -(X+D (A-SQRT(A+B)) 

4. If E is an unsigned «*jf ^j " *"*!! ** F **| 
expression, then: F+E, F-E, F*E, F/E and F E 
are all expressions. 

Examples: 

-(B(I,J)+SQRT(A+B(K,L))) 

1.7E-2** (X+5.0) 
-(B(I + 3,3*J+5)+A) 
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5. An evaluated expression may be Integer, Real, 
Double Precision, or Logical. The type is 
determined by the data types of the elements of 
the expression. If the elements of the 
expression are not all of the same type, the 
type of the expression is determined by the 
element having the highest type. The type 
hierarchy (highest to lowest) is as follows: 
DOUBLE PRECISION, REAL, INTEGER, LOGICAL. 

6. Expressions may contain nested parenthesized 
elements as in the following: 

A*(Z-( (Y+X)/T) )**J 

where Y+X is the innermost element, (Y+X)/T is 
the next innermost, Z-((Y+X)/T) the next. In 
such expressions, care should be taken to see 
that the number of left parentheses and the 
number of right parentheses are equal. 



4.2 EXPRESSION EVALUATION 

Arithmetic expressions are evaluated according to 
the following rules: 

1. Parenthesized expression elements are evaluated 
first. If parenthesized elements are nested, 
the innermost elements are evaluated, then the 
next innermost until the entire expression has 
been evaluated. 

2. Within parentheses and/or wherever parentheses 
do not govern the order or evaluation, the 
hierarchy of operations in order of precedence 
is as follows: 

a. FUNCTION evaluation 

b. Exponentiation 

c. Multiplication and Division 

d. Addition and Subtraction 

Example: 

The expression 

A* (Z-( (Y+R)/T) )**J+VAL 
is evaluated in the following sequence: 
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Y+R = e1 
(e1)/T = e2 
Z-e2 = e3 
e3**J = e4 
A*e4 = e5 
e5+VAL = e6 



3. The expression x**Y**Z is not allowed. It 
should be written as follows: 

( X **Y)**z or X** (Y**Z) 



4. Use of an array element reference requires the 
evaluation of its subscript. Subscript 
expressions are evaluated under the same rules 
as other expressions. 



4.3 LOGICAL EXPRESSIONS 

A Logical Expression may be any of the following: 



1. A single Logical Constant (i.e., .TRUE. or 
.FALSE.), a Logical variable, Logical Array 
Element or Logical FUNCTION reference (see 
FUNCTION, Section 9). 

2. Two arithmetic expressions separated by a 
relational operator (i.e., a relational 
expression) . 

3. Logical operators acting upon logical 
constants, logical variables, logical array 
elements, logical FUNCTIONS, relational 
expressions or other logical expressions. 
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The value of a logical expression is always either 
.TRUE. or .FALSE. 



4.3.1 RELATIONAL EXPRESSIONS 

The general form of a relational expression is as 
follows: 

e1 r e2 

where e1 and e2 are arithmetic expressions and r is 
a relational operator. The six relational 
operators are as follows: 

.LT. Less Than 

.LE. Less than or equal to 

.EQ. Equal to 

.NE. Not equal to 

.GT. Greater than 

.GE. Greater than or equal to 

The value of the relational expression is .TRUE, 
if the condition defined by the operator is met. 
Otherwise, the value is .FALSE. 

Examples; 

A.EQ.B 
(A**J) .GT. (ZAP* (RHO*TAU-ALPH) ) 



4.3.2 LOGICAL OPERATORS 

Table 4-1 lists the logical operations. U and V 
denote logical expressions. 
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Table 4-1. Logical Operations 



.NOT.U The value of this expression is the 

logical complement of U (i.e., 1 
bits become and bits become 1). 

U.AND.V The value of this expression is the 

logical product of U and V (i.e., 
there is a 1 bit in the result only 
where the corresponding bits in both 
U and V are 1 . 

U.OR.V The value of this expression is the 

logical sum of U and V (i.e., there 
is a 1 in the result if the 
corresponding bit in U or V is 1 or 
if the corresponding bits in both U 
and V are 1 . 

U.XOR.V The value of this expression is the 

exclusive OR of U and V (i.e., there 
is a one in the result if the 
corresponding bits in U and V are 1 
and or and 1 respectively. 

Examples; 

If U = 01101100 and V = 11001001 , then 

.NOT.U = 1001001 1 
U.AND.V = 01001000 
U.OR.V = 11101 101 
U.XOR.V = 10100101 



I 
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The following are additional considerations for 
construction of Logical expressions: 

1. Any Logical expression may be enclosed in 
parentheses. However, a Logical expression to 
which the .NOT. operator is applied must be 
enclosed in parentheses if it contains two or 
more elements. 

2. In the hierarchy of operations, parentheses may 
be used to specify the ordering of the 
expression evaluation. Within parentheses, and 
where parentheses do not dictate evaluation 
order, the order is understood to be as 
follows: 

a. FUNCTION Reference 

b. Exponentiation (**) 

c. Multiplication and Division (* and /) 

d. Addition and Subtraction (+ and -) 

e. .LT., .LE., .EQ., .NE. , .GT., .GE. 

f . . NOT . 

g . . AND . 

h. .OR., .XOR. 

Examples: 

The expression 

X .AND. Y .OR. B(3,2) .GT. Z 

is 



evaluc 


ited as 


e1 = 


= B ( 3 , 2 ) . GT . Z 


e2 = 


= X .AND. Y 


e3 = 


= e2 .OR. e1 



The expression 

X .AND. (Y .OR. B(3,2) .GT. Z) 
is evaluated as 

e1 = B(3,2) .GT. Z 
e2 = Y .OR. e1 
e3 = X .AND. e2 

3. It is invalid to have two contiguous logical 
operators except when the second operator is 
.NOT. 
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That is, 

.AND. .NOT. 
and 

.OR. .NOT. 
are permitted. 
Example: 

A. AND.. NOT. B is permitted 

A. AND.. OR. B is not permitted 

4.4 HOLLERITH, LITERAL, AND HEXADECIMAL CONSTANTS IN 
EXPRESSIONS 

Hollerith, Literal, and Hexadecimal constants are 
allowed in expressions in place of Integer 
constants. These special constants always evaluate 
to an Integer value and are therefore limited to a 
length of two bytes. The only exceptions to this 
are : 

1. Long Hollerith or Literal constants may be used 
as subprogram parameters. 

2. Hollerith, Literal, or Hexadecimal constants 
may be up to four bytes long in DATA statements 
when associated with Real variables, or up to 
eight bytes long when associated with Double 
Precision variables. 
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SECTION 5 
REPLACEMENT STATEMENTS 



Replacement statements define computations and are used 
similarly to equations in normal mathematical notation. 
They are of the following form: 

v = e 

where v is any variable or array element and e is an 
expression. 

FORTRAN semantics defines the equality sign (=) as meaning 
to be replaced by rather than the normal is equivalent to . 
Thus, the object program instructions generated Ey a 
replacement statement will, when executed, evaluate the 
expression on the right of the equality sign and place that 
result in the storage space allocated to the variable or 
array element on the left of the equality sign. 

The following conditions apply to replacement statements: 



Both v and the equality sign must appear on the 
same line. This holds even when the statement is 
part of a logical IF statement (section 7) . 

Example : 

C IN A REPLACEMENT STATEMENT THE »=' 
C MUST BE IN THE INITIAL LINE. 
A (_5 3) = 

1 B(7,2) + SIN(C) 

The line containing v= must be the initial line of 
the statement unless the statement is part of a 
logical IF statement. In that case the v= must 
occur no later than the end of the first line after 
the end of the IF. 

If the data types of the variable, v, and the 
expression, e, are different, then the value 
determined by the expression will be converted, if 
possible, to conform to the typing of the variable. 
Table 5-1 shows which type expressions may be 
equated to which type of variable. Y indicates a 
valid replacement and N indicates an invalid 
replacement. Footnotes to Y indicate conversion 
considerations . 
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Table 5-1. Replacement By Type 



Variable 
Types 


Expression Types (e) 


Integer 


Real 


Logical 


Double 


Integer 
Real 
Logical 
Double 


Y 

Yc 
Yd 
Yc 


Ya 
Y 

Ya 
Y 


Yb 
Yc 
Y 
Yc 


Ya 
Ye 
Ya 
Y 



a. The Real expression value is converted to Integer, 
truncated if necessary to conform to the range of 
Integer data. 

b. The sign is extended through the second byte. 

c. The variable is assigned the Real approximation of 
the Integer value of the expression. 

d. The variable is assigned the truncated value of the 
Integer expression (the low-order byte is used, 
regardless of sign) . 

e. The variable is assigned the rounded value of the 
Real expression. 
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SECTION 6 
SPECIFICATION STATEMENTS 



Specification statements are non-executable, non-generative 
statements which define data types of variables and arrays, 
specify array dimensionality and size, allocate data storage 
or otherwise supply determinative information to the FORTRAN 
processor. DATA intialization statements are 
non-executable, but generate object program data and 
establish initial values for variable data. 

6.1 SPECIFICATION STATEMENTS 

There are six kinds of specification statements. 
Theyare as follows: 

Type, EXTERNAL, and DIMENSION statements 

COMMON statements 

EQUIVALENCE statements 

DATA initialization statements 

All specification statements are grouped at the 
beginning of a program unit and must be ordered as 
they appear above. Specification statements may be 
preceded only by a FUNCTION, SUBROUTINE, PROGRAM or 
BLOCK DATA statement. All specification statements 
must precede statement functions and the first 
executable statement. 



6.2 ARRAY DECLARATORS 

Three kinds of specification statements may specify 
array declarators. These statements are the 
following: 

Type statements 
DIMENSION statements 
COMMON statements 

Of these, DIMENSION statements have the declaration 
of arrays as their sole function. The other two 
serve dual purposes. These statements are defxned 
in subparagraphs 6.3, 6.5 and 6.6. 

Array declarators are used to specify the name, 
dimensionality and sizes of arrays. An array may 
be declared only once in a program unit. 

An array declarator has one of the following forms: 
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ui ( k ) 

ui (k1,k2) 

ui (k1,k2,k3) 

where ui is the name of the array, called the 
declarator name, and the k's are integer constants. 

Array storage allocation is established upon 
appearance of the array declarator. Such storage 
is allocated linearly by the FORTRAN processor 
where the order of ascendancy is determined by the 
first subscript varying most rapidly and the last 
subscript varying least rapidly. 

For example, if the array declarator AMAT (3,2,2) 
appears, storage is allocated for the 12 elements 
in the following order: 

AMAT (1,1,1), AMAT (2,1,1), AMAT (3,1,1), AMAT (1,2,1), 
AMAT(2,2,1), AMAT(3,2,1), AMAT ( 1 , 1 , 2 ) , AMAT(2,1,2), 
AMAT(3,1,2), AMAT(1,2,2), AMAT(2,2,2), AMAT(3,2,2) 



6.3 



TYPE STATEMENTS 

Variable, array and FUNCTION names are 
automatically typed Integer or Real by the 
"predefined 1 convention unless they are changed by 
Type statements. For example, the type is Integer 
if the first letter of an item is I, J, K, L, 
N. Otherwise, the type is Real. 



M 



or 



Type statements provide for overriding or 
confirming the pre-defined convention by specifying 
the type of an item. In addition, these statements 
may be used to declare arrays. 

Type statements have the following general form: 
t v1 ,v2 , . . . vn 

where t represents one of the terms INTEGER, 
INTEGER* 1, INTEGER* 2, REAL, REAL* 4, REAL* 8, DOUBLE 
PRECISION, LOGICAL, LOGICAL* 1, LOGICAL* 2, or BYTE. 
Each v is an array declarator or a variable, array 
or FUNCTION name. The INTEGER* 1, INTEGER* 2, 
REA-,*4, REAL*8, LOGICAL* 1 , and LOGICAL*2 types are 
allowed for readability and compatibility with 
other FORTRANs. BYTE, INTEGER* 1 , LOGICAL* 1 and 
LOGICAL are all equivalent; INTEGER*2, LOGICAL*2, 
and INTEGER are equivalent; REAL and REAL* 4 are 
equivalent; DOUBLE PRECISION and REAL* 8 are 
equivalent. 
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Example: 

REAL AMAT (3,3,5) ,BX, IETA,KLPH 



NOTE 

1. AMAT and BX are redundantly typed. 

2. IETA and KLPH are unconditionally 
declared Real. 

3. AMAT (3, 3,5) is a constant array 
declarator specifying an array of 45 
elements. 



Example: 

INTEGER M1, HT, JMP(15), FL 

NOTE 

M1 is redundantly typed here. Typing of HT 
and FL by the pre-defined convention is 
overridden by their appearance in the 
INTEGER statement. JMP(15) is a constant 
array declarator. It redundantly types the 
array elements as Integer and communicates 
to the processor the storage requirements 
and dimensionality of the array. 



Example : 

LOGICAL L1, TEMP 



NOTE 



All variables, arrays or FUNCTIONS required 
to be typed Logical must appear in a 
LOGICAL statement, since no starting letter 
indicates these types by the default 
convention. 



f 
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6.4 EXTERNAL STATEMENTS 

EXTERNAL statements have the following form: 

EXTERNAL u1 , u2 , . . . , un 

where each ui is a SUBROUTINE, BLOCK DATA or 
FUNCTION name. When the name of a subprogram is 
used as an argument in a subprogram reference, it 
must have appeared in a preceding EXTERNAL 
statement. 

When a BLOCK DATA subprogram is to be included in a 
program load, its name must have appeared _ in an 

EXTERNAL statement within the main program unit. 

For example, if SUM and AFUNC are subprogram names 
to be used as arguments in the subroutine SUBR, the 
following statements would appear in the calling 
program unit: 



EXTERNAL SUM, AFUNC 



CALL SUBR (SUM, AFUNC, X,Y) 

6.5 DIMENSION STATEMENTS 

A DIMENSION statement has the following form: 

DIMENSION u2,u2,u3,. . . , un 
where each ui is an array declarator. 

Example: 

DIMENSION RAT(5,5) ,BAR(20) 

This statement declares two arrays - the 25 element 
array RAT and the 2 element array BAR. 

6.6 COMMON STATEMENTS 

COMMON statements are non-executable, storage 
allocating statements which assign variables and 
arrays to a storage area called COMMON storage and 
provide the facility for various program units to 
share the use of the same storage area. 
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COMMON statements are expressed in the following 

form; f 

COMMON /Y1/A1/Y2/A2/... /Yn/An 

where each Yi is a COMMON block storage name and 
each Ai is a sequence of variable names, array 
names or constant array declarators, separated by 
commas. The elements in Ai make up the COMMON 
block storage area specified by the name Yi. If 
any Yi is omitted leaving two consecutive slash 
characters (//) , the block of storage so indicated 
is called blank COMMON. If the first block name 
(Y1) is omitted, the two slashes may be omitted. 

Example; 

COMMON /AREA/A , B , C/BDATA/X , Y , Z , 
X FL,ZAP(30) 

In this example, two blocks of COMMON storage are 

allocated - AREA with space for three variables and 

BDATA, with space for four variables and the 30 
element array, ZAP. 

Example 

COMMON //A1 ,B1/CDATA/Z0T(3,3) 
X ' //T2,Z3 

In this example, A1 , B1 , T2 and Z3 are assigned to 
blank COMMON in : that order. The pair of slashes 
preceding A1 could have been omitted. 

CDATA names COMMON block storage for ' the nine 
element array, ZOT and thus ZOT (3,3) is an array 
declarator. ZOT must not have been previously 
declared . (See "Array Declarators," Paragraph 
6.3.1 

Additional Considerations: 

1 . The name of a COMMON block may appear more than 
once in the same COMMON statement, or in more 
than one COMMON statement. 



A COMMON block name is made up' of from 1 to 6 

alphanumeric characters',- the first of which 

must be a letter .W i~J$m L *>^$@£$*fi 

' t<& '-3 -,'>." v.-:.' ■ " • 

A COMMON block.nSfer^pii%fem||#||:#ferent from any 
subprogram name's' u'se®®%hrf%'gn'6'ut' the program. 



( 
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4 The size of a COMMON area may be increased by 
the use of EQUIVALENCE statements. See 
"EQUIVALENCE Statements," Paragraph 6.7. 

5 The lengths of COMMON blocks of the same name 
need not be identical in all program units 
where the name appears. However, if the 
lengths differ, the program unit specifying the 
greatest length must be loaded first (see the 
discussion of LINK-80 in the User's Guide). 
The length of a COMMON area is the number ot 
storage units required to contain the variables 
and arrays declared in the COMMON statement (or 
statements) unless expanded by the use of 
EQUIVALENCE statements. 

6 .7 EQUIVALENCE STATEMENTS 

Use of EQUIVALENCE statements permits the sharing 
of the same storage unit by two or more entities. 
The general form of the statement is as follows: 

EQUIVALENCE (u1 ), (u2 ),..., (un) 

where each ui represents a sequence of two or more 
variables or array elements, separated by commas. 
Each element in the sequence is assigned the same 
storage unit (or portion of a storage unit) by the 
processor. The order in which the elements appear 
is not significant. 

Example: 

EQUIVALENCE (A,B,C) 

The variables A, B and C will share the same 
storage unit during object program execution. 

If an array element is used in an EQUIVALENCE 
statement, the number of subscripts must be the 
same as the number of dimensions established by the 
array declarator, or it must be one, where the one 
subscript specifies the array element's number 
relative to the first element of the array. 

Example: 

If the dimensionaliity of an array, Z, has been 
declared as Z(3,3) then in an EQUIVALENCE statement 
Z(6) and Z(3,2) have the same meaning. 
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Additonal Considerations: 

• 4. «f arrav elements must be 
1. The subscripts of array 
integer constants. 

be 



2. An e 
refe 



3 



lem ent of a ~lti-«i«n.^ ""^^ 

rred to by a single subscript, 

COMMON block 



share the 



variables may be assigned to a 
• tnrougn EQUIVALENCE statements. 

Example; 

COMMON /X/A,B,C 
EQUIVALENCE (A,D) 

In m. «... ^-^SAxocA. 

first storage unit: m 

4.^ r^n increase the size of 
4. EQUIVALENCE statements can * statement by 
a block indicated by a Qf fche block . 
adding more elements to tne 

Example: I 

DIMENSION R(2,2) 
COMMON /Z/W,X,Y 
EQUIVALENCE (Y,R(3)) 

llHna COMMON block will have the 
The resulting l - uu " J ' 1 
following configuration: 

Variable Storag_e Unit 

W = L(1,D ° 

X = R(2,D 1 

Y *= Rd,2) 2 

R(2,2) 3 

v,i • v, ri bv the COMMON 
Th e COMMON block «taM^e£ e y ^ 

S^S'toTr^. 3 -"'". * «» EOCXVAXENCE 
statement. 

w innrpased only from 
COMMON block ^ze may be xncre coMMON 

ftatemeft £ S not^^ta /irst eXement 

backward. 

No te that EOXUVALENCE ( X , R ( 3 ) » »ul a be^invaX^ ( ) 

in the example. l ^ o1 « men t in the 



in J, he ,.dT m ^ ^e first element 
established W 

COMMON block 

equivalent wo\ 

first element, 



established « as jf^^VSe x and »(3) 
^axen^eo^fbrafattempt to maKe Kd, the 
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5. It is invalid to EQUIVALENCE two elements of 
the same array or two elements belonging to the 
same or different COMMON blocks. 



Example; 



DIMENSION XTABLE (20), D(5) 
COMMON A,B(4)/ZAP/C,X 



EQUIVALENCE (XTABLE (6), A (7) 
X B ( 3 ) , XTABLE ( 5 ) ) , 

Y (B(3),D(5)) 



This EQUIVALENCE statement has the following 
errors : 

1 . It attempts to EQUIVALENCE two elements of the 
same array, XTABLE (6) and XTABLE (15). 

2. It attempts to EQUIVALENCE two elements of the 
same COMMON block, A (7) and B(3). 

3. Since A is not an array, A(7) is an illegal 
reference. 

4. Making B(3) equivalent to D(5) extends COMMON 
backwards from its defined starting point. 



6 - 8 DATA INITIALIZATION STATEMENT 

The DATA initialization statement is a 
non-executable statement which provides a means of 
compiling data values into the object program and 
assigning these data to variables and array 
elements referenced by other statements. 

The statement is of the following form: 

DATA list/u1 ,u2, . . . ,un/,list. . ./uk,uk+1 ,. . . uk+n/ 

where "list" represents a list of variable, array 
or array element names, and the ui are constants 
corresponding in number to the elements in the 
list. An exception to the one-for-one 
correspondence of list items to constants is that 
an array name (unsubscripted) may appear in the 
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to fill 



list, and as many con ^ants as necessary to "^ 
the array may appear in the correspon 9^. ssible 

£!£.' SU^-dS-J-SS-S; may not appear 

in the list. 



Example 

DIMENSION 

nafa A. B. . . 

-8.1,2*7.5/ 



DIMENSION C(7) 

DATA A, B, C(1),C(3£/14.73 f 

X 



This implies that 

A-14.73, B=-8.1, C(D=7.5, C(3)=7.5 

v, octant ui must match the type of 
The type of each ^J"*^ 1 ^ li8tf except that a 
the corresponding item in the i » ^ th &n 
Hollerith or Literal constant may u y 
item of any type. 

When a Hollerith or Literal coM^'^'belS 
"Tr °than C roart e imls S. -« of'storage units 
9 r r q urr r ea tha by f0a the corresponding , rtem r-. 1 
character for ^^rcal varrjble,^ 5 »r fewer 

characters for an ^ nte y" 
characters for a Real variable. 

•4-v, ^r- literal characters are 
"fried, "trailing hlan^'are added to fill the 
remainder of storage. 

j 4 « a cimilar fashion. 
Hexadecimal data f ^ored inj s^ila^ used, 
If fewer Hexadecimal character ^ 

sufficient leading zeros are added 
remainder of the storage unit. 

,. n nin.rrate many of the features 
The examples below illustrate many 

of the DATA statement. 
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DIMENSION HARY (2) 
DATA HARY,B/ 4HTHIS, 4H OK. 
1 ,7.86/ 



REAL LIT (2) 

LOGICAL LT,LF 

DIMENSION H4(2,2) ,PI3(3) 

DATA A1,B1,K1,LT,LF,H4 (1,1) ,H4 (2,1) 

1 H4(1,2) ,H4(2,2) , PI3/5 . 9 , 2 . 5E-4 , 

2 64,. FALSE. , .TRUE. ,1.75E-3, 

3 0.85E-1, 2*75. 0,1. ,2. ,3.14159/ 

4 LIT(1)/'NOGO'/ 
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SECTION 7 
FORTRAN CONTROL STATEMENTS 



FORTRAN control statements are executable statements which 
affect and guide theological flow of a FORTRAN program. The 
statements in this category are as follows: 



1 . GO TO, statements : 

1 . Unconditional GO TO 

2. Computed GO TO 

3. Assigned GO TO 

2. ASSIGN 

3. IF statements: 

1 . Arithmetic IF 

2. Logical IF 

4. DO 

5. CONTINUE 

6. STOP 



7. 1 "" PAUSE 



8. CALL 

« 

9. RETURN 

When statement labels of other statements are a part of a 
control statement, such statement labels must be associated 
with executable statements within the same program unit in 
which the control statement appears. 



7.1 GO TO STATEMENTS 



7.1.1 UNCONDITIONAL GO TO 

Unconditional GO TO statements are used whenever 
control is to be transferred unconditionally to 
some other statement within the program unit. 



V 



FORTRAN-80 Reference Manual Page 45 

The statement is of the following form: 
GO TO k 

where k is the statement label of an executable 
statement in the same program unit. 

Example : 

GO TO 376 
310 A(7) = V1 -A(3) 

37 6 A (2) =VECT 
GO TO 310 

In these statements, statement 376 is ahead of 
statement 310 in the logical flow of the program of 
which they are a part. 

7.1.2 COMPUTED GO TO 

Computed GO TO statements are of the form: 
GO TO (k1 ,k2, . . . ,n) , j 

where the ki are statement labels, and j is an 
integer variable, 1 < j < n. 

This statement causes transfer of control to the 
statement labeled k j . If j < 1 or j >n,_ control 
will be passed to the next statement following the 
Computed GOTO. 

Example: 

J=3 



GO TO(7, 70, 700, 7000, 70000), J 
310 J=5 

GO TO 32 5 

When J = 3, the computed GO TO transfers control to 
statement 700. Changing J to equal 5 changes the 
transfer to statement 70000. Making J = or J - 6 
would cause control to be transferred to statement 
310. 



7.1.3 ASSIGNED GO TO 

Assigned GO TO statements are of the following 
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form: 

GO TO j, (k1 ,k2,... ,kn) 

or 

GOTO J 

where J is an integer variable name, and the ki are 
statement labels of executable statements. This 
statement causes transfer of control to the 
statement whose label is equal to the current value 
of J. 

Qualifications 

1. The ASSIGN statement must logically precede an 
assigned GO TO. 

2. The ASSIGN statement must assign a value to J 
which is a statement label included in the list 
of k's, if the list is specified. 

Example : 

GO TO LABEL, (80,90, 100) 

Only the statement labels 80, 90 or 100 may be 
assigned to LABEL. 

7.2 ASSIGN STATEMENT 

This statement is of the following form: 

ASSIGN j TO i 

where j is a statement label of an executable 
statement and i is an integer variable. 

The statement is used in conjunction with each 
assigned GO TO statement that contains the integer 
variable i. When the assigned GO TO is executed, 
control will be transferred to the statement 
labeled j . 
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Example: 

ASSIGN 100 TO LABEL 



ASSIGN 90 TO LABEL 

GO TO LABEL, (80,90,100) 



7.3 IF STATEMENT 

IF statements transfer control to one of a series 
of statements depending upon a condition. Two 
types of IF statements are provided: 

Arithmetic IF 
Logical IF 

7.3.1 ARITHMETIC IF 

The arithmetic IF statement is of the form: 
IF(e) m1,m2,m3 

where e is an arithmetic expression and ml , m2 and 
m3 are statement labels. 

Evaluation of expression e determines one of three 
transfer possibilities: 

If e is: Transfer to: 

< ml 

= m2 

> m3 

Examples : 

Statement Expression Value Transfer to 

IF (A)3,4,5 15 \ 

IF (N-1)50,73,9 '* 

IF (AMTX(2,1,2))7,2,1 -256 ' 

7.3.2 LOGICAL IF 

The Logical IF statement is of the form: 

IF (u)s 

where u is a Logical expression and s is any 
executable statement except a DO statement (see 
7 4) or another Logical IF statement. The Logical 
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^,,1,,-i.^ as .TRUE. or .FALSE, 
expression u is evaluat *f ^^i* D f Logical 
Section 4 contains a discussion 

expressions. 

Control Conditions: 

If u i. FALSE, tne statement s is f i ? nored g and 

control goes to the next st expression 

Logical " statement. "; h °^«' statement- s, and 

is TRUE, then control goes to t ws normal 

subsequent program control 

conditions. 

!f s is a ir^TTauTntTtlVM lusTteZ the 

Examples; 

1. IF(I.GT.20) GO TO 115 

2. IF(Q.AND.R) ASSIGN 10 TO J 

3. IF(Z) CALL DECL(A,B,C) 

4. IF(A.0R.B.LE.PI/2)I=J 

5. IF(A.OR.B.LE.Pl/2) 

X i=J 



7.4 



DO STATEMENT 

ThS " .2° T^thoa for ^PeUti^/^ecnSn^ 
^erTefof stared. The statement takes of one 
of the two following forms: 



1) 



DO k i = ml ,m2,m3 



or 

2) DO k i = ml * m2 

-here K is a. statement label, i^i. » ^?nte g « 

logical variable, and m i , i l 

constants or integer or logical variables. 

If m3 is 1, it may be omitted as in 2) above. 

The following conditions and restrictions govern 

the use of DO statements: 
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1. The DO and the first comma must appear on the 
initial line. 

2. The statement labeled k, called the terminal 
statement, must be an executable statement. 

3. The terminal statement must physically follow 
its associated DO, and the executable 
statements following the DO, up to and 
including the terminal statement, constitute 
the range of the DO statement. 

4 The terminal statement may not be an Arithmetic 
IF, GO TO, RETURN, STOP, PAUSE or another DO. 

5. If the terminal statement is a logical IF and 
its expression is .FALSE., then the statements 
in the DO range are reiterated. 

If the expression is .TRUE., the statement of 
the logical IF is executed and then the 
statements in the DO range are reiterated. The 
statement of the logical IF may not be a GO TO, 
Arithmetic IF, RETURN, STOP or PAUSE. 

6. The controlling integer variable, i, is called 
the index of the DO range. The index must be 
positive and may not be modified by any 
statement in the range. 

7 If ml, m2, and m3 are Integer* 1 variables or 

constants, the DO loop will execute faster and 

be shorter, but the range is limited to Ml 

iterations. For example, the loop overhead for 

a DO loop with a constant limit and an 

increment of 1 depends upon the type of the 
index variable as follows: 

Index Variable Overhead 

T yp e Microseconds Bytes 



INTEGER* 2 
INTEGER* 1 



35.5 19 

24 14 



8 During the first execution of the statements in 
the DO range, i is equal to ml ; the second 
execution, i = m1+m3; the third, i=m1+2*m3, 
etc., until i is equal to the highest value in 
this sequence less than or equal to m2 , and 
then the DO is said to be satisfied. The 
statements in the DO range will always be 
( executed at least once, even if ml < m2 . 

When the DO has been satisfied, control passes 
to the statement following the terminal 
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statement, otherwise control transfers back to 
the first executable statement following the DO 
statement. 

Example; 

The following example computes 

Sigma Ai where a is a one-dimensional array 
i=1 



100 DIMENSION A(100) 



SUM = A(1) 
DO 31 I = 2,100 
31 SUM =SUM + A (I) 

END 

The range of a DO statement may be extended to 
include all statements which may logically be 
executed between the DO and its terminal 
statement. Thus, parts of the DO range may be 
situated such that they are not Physically 
between the DO statement and its terminal 
statement but are executed logically m the DO 
range. This is called the extended range. 

Example: 

DIMENSION A(500), B(500) 



DO 50 I = 10, 327, 3 

9 

IF (V7 -C*C) 20,15,31 
30 

50 A(D = B(I) + C 



20 C = C - .05 
GO TO 50 

31 C=C+ .0125 
GO TO 30 



i I 
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10. It is invalid to transfer control into the 
range of a DO statement not itself in the range 
or extended range of the same DO statement. 

11. Within the range of a DO statement, there may 
be other DO statements, in which case the DO's 
must be nested. That is, if the range of one 
DO contains another DO, then the range of the 
inner DO must be entirely included in the range 
of the outer DO. 

The terminal statement of the inner DO may also 
be the terminal statement of the outer DO. 

For example, given a two dimensional array A of 
15 rows and 15 columns, and a 15 element 
one-dimensional array B, the following 
statements compute the 15 elements of array C 
to the formula: 

15 

Ck =Sigma AkjBm, k = 1,2,. ..,15 
j = 1 

DIMENSION A( 15,15), B(15), C(15) 



DO 80 K =1,15 
C(K) = 0.0 
DO 80 J=1 , 15 
80 C(K) = C(K) +A(K,J) * B(J) 



7.5 CONTINUE STATEMENT 



CONTINUE is classified as an executable statement. 
However, its execution does nothing. The form of 
the CONTINUE statement is as follows: 

CONTINUE 

CONTINUE is frequently used as the terminal 
statement in a DO statement range when the 
statement which would normally be the terminal 
statement is one of those which are not allowed or 
isonly executed conditionally. 
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Example; 

DO 5 K = 1,10 



IF (C2) 5,6,6 
6 CONTINUE 



C2 = C2 +.005 
5 CONTINUE 



7.6 STOP STATEMENT 

A STOP statement has one of the following forms: 

STOP 

or 

STOP c 

where c is any string of one to six characters. 

When STOP is encountered during execution of the 

object program, the characters c (if present) are 

displayed on the operator control console and 
execution of the program terminates. 

The STOP statement, therefore, constitutes the 
logical end of the program. 

7.7 PAUSE STATEMENT 

A PAUSE statement has one of the following forms: 

PAUSE 

or 

PAUSE c 

where c is any string of up to six characters. 

When PAUSE is encountered during execution of the 

object program, the characters c (if present) are 

displayed on the operator control console and 
execution of the program ceases. 

The decision to continue execution of the program 
is not under control of the program. If execution 
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is resumed through intervention of an operator 
without otherwise changing the state of the 
processor, the normal execution sequence, following 
PAUSE, is continued. 

Execution may be terminated by typing a "T" at the 
operator console. Typing any other character will 
cause execution to resume. 



7.8 CALL STATEMENT 

CALL statements control transfers into SUBROUTINE 
subprograms and provide parameters for use by the 
subprograms. The general forms and detailed 
discussion of CALL statements appear in Section 9, 

FUNCTIONS AND SUBPROGRAMS. 



7.9 RETURN STATEMENT 

The form, use and interpretation of the RETURN 
statement is described in Section 9. 



7.10 END STATEMENT 

The END statement must physically be the last 
statement of any FORTRAN program. It has the 
following form: 

END 

The END statement is an executable statement and 
may have a statement label. It causes a transfer 
of control to be made to the system exit routine 
$EX, which returns control to the operating system. 



( 
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SECTION 8 
INPUT / OUTPUT 

FORTRAN provides a series of statements which define the 
control and conditions of data transmission between computer 
memory and external data handling or mass storage devices 
such as magnetic tape, disk, line printer, punched card 
processors, keyboard printers, etc. 

These statements are grouped as follows: 



1 • Formatted READ and WRITE statements which cause 
formatted information to be transmitted between the 
computer and I/O devices. 

2 " Unformatted READ and WRITE statements which 
transmit unformatted binary data in a form similar 
to internal storage. 

3 - Auxiliary I/O statements for positioning and 
demarcation of files. 

4 « ENCODE and DECODE statements for transferring data 
between memory locations. 

5. FORMAT statements used in conjunction with 
formatted - record transmission to provide data 
conversion and editing information between internal 
data representation and external character string 
forms . 



8 . 1 FORMATTED READ/WRITE STATEMENTS 
8.1.1 FORMATTED READ STATEMENTS 

A formatted READ statement is used to transfer 
information from an input device to the computer. 

Two forms of the statement are available, as 
follows : 

READ (u,f ,ERR=L1 ,END=L2) k 
or 

READ (u,f ,ERR=L1 ,END=L2) 

where : 

u - specifies a Physical and Logical Unit Number 

and may be either an unsigned integer or an 
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integer variable in the range 1 through 255. 

If an Integer variable is used, an Integer 

value must be assigned to it prior to execution 
of the READ statement. 

Units 1, 3, 4, and 5 are preassigned to the 
console Teletypewriter. Unit 2 is preassigned 
to the Line Printer (if one exists). Units 
6-10 are preassigned to Disk Files (see 
Appendix E) . These units, as well as units 11 
- 255, may be re-assigned by the user (see 
Appendix B) . 

f - is the statement label of the FORMAT statement 
describing the type of data conversion to be 
used within the input transmission or it may be 
an array name, in which case the formatting 
information may be input to the program at the 
execution time. (See 8.7.10) 

L1- is the FORTRAN label on the statement to which 
the I/O processor will transfer control if an 
I/O error is encountered. 

L2- is the FORTRAN label on the statement to which 
the I/O processor will transfer control if an 
End-of-File is encountered. 

k - is a list of variable names, separated by com- 
mas, specifying the input data. 

READ (u,f)k is used to input a number of items, 
corresponding to the names in the list k, from the 
file on logical unit u, and using the FORMAT 
statement f to specify the external representation 
of these items (FORMAT statements, 8.7) The ERR- 
and END= clauses are optional. If not specified, 
I/O errors and End-of-Files cause fatal runtime 
errors. 

The following notes further define the function of 
the READ (u,f)k statement: 

1 Each time execution of the READ statement 
begins, a new record from the input file is 
read. 

2. The number of records to be input by a single 
READ statement is determined by the list, k, 
and format specifications. 

3 The list k specifies the number of items to be 
read from the input file and the locations into 
which they are to be stored. 
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4. Any number of items may appear in a single list 
and the items may be of different data types. 

5. If there are more quantities in an input record 
than there are items in the list, only the 
number of quantities equal to the number of 
items in the list are transmitted. Remaining 
quantities are ignored. 

6. Exact specifications for the list k are 
described in 8.6. 

Examples : 

1 . Assume that four data entries are punched in a 
card, with three blank columns separating each, 
and that the data have field widths of 3, 4, 2 
and 5 characters respectively starting in 
column 1 of the card. The statements 

READ(5,20)K,L,M,N 
20 F0RMAT(I3,3X,I4,3X,I2,3X,I5) 

will read the card (assuming the Logical Unit 
Number 5 has been assigned to the card reader) 
and assign the input data to the variables K, 
L, M and N. The FORMAT statement could also be 

20 FORMAT (13,17,15,18) 

See 8.7 for complete description of FORMAT 
statements. 

2. Input the quantities of an array (ARRY) : 

READ (6,21) ARRY 

Only the name of the array needs to appear in 
the list (see 3.6). All elements of the array 
ARRY will be read and stored using the 
appropriate formatting specified by the FORMAT 
statement labeled 21. 

READ(u,k) may be used in conjunction with a FORMAT 
statement to read H-type alphanumeric data into an 
existing H-type field (see Hollerith Conversions, 
8.7.3) . 

For example, the statements 
READ (I ,25) 



2 5 FORMAT ( 1 OHABCDEFGHI J) 
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cause the next 10 characters of the file on input 
device I to be read and replace the characters 
ABCDEFGHIJ in the FORMAT statement. 

8.1.2 FORMATTED WRITE STATEMENTS 

A formatted WRITE statement is used to transfer 
information from the computer to an output device. 

Two forms of the statement are available, as 
follows : 

WRITE (u,f,ERR=Ll ,END=L2)k 

or 

WRITE (u, f ,ERR=L1 ,END=L2) 
where : 
u _ specifies a Logical Unit Number. 

f - is the statement label of the FORMAT statement 
describing the type of data conversion to be 
used with the output transmission. 

L1- specifies an I/O error branch. 

L2- specifies an EOF branch. 

k - is a list of variable names separated by com- 
mas, specifying the output data. 

WRITE (u,f)k is used to output the data specified 
in the list k to a file on logical unit u using the 
FORMAT statement f to specify the external 
representation of the data (see FORMAT statements, 
8.7). The following notes further define the 
function of the WRITE statement: 

1. Several records may be output with a single 
WRITE statement, with the number determined by 
the list and FORMAT specifications. 

2. Successive data are output until the data 
specified in the list are exhausted. 

3. If output is to a device which specifies fixed 
length records and the data specified in the 
list do not fill the record, the remainder of 

( the record is filled with blanks. 



FORTRAN-80 Reference Manual Page 58 

Example: 

WRITE(2, 10)A,B,C,D 

The data assigned to the variables A, B f C and D 
are output to Logical Unit Number 2, formatted 
according to the FORMAT statement labeled 10. 

WRITE (u,f) may be used to write alphanumeric 
information when the characters to be written are 
specified within the FORMAT statement. In this 
case a variable list is not required. 

For example, to write the characters 'H CONVERSION' 
on unit 1 , 

WRITE (1,26) 



2 6 FORMAT (12HH CONVERSION) 

8.2 UNFORMATTED READ/WRITE 

Unformatted I/O (i.e. without data conversion) is 
accomplished using the statements: 

READ(U,ERR=L1 ,END=L2) k 
WRITE (U,ERR=L1,END=L2) k 

where : 

u - specifies a Logical Unit Number. 

L1- specifies an I/O error branch. 

L2- specifies an EOF branch. 

k - is a list of variable names, separated by 
commas, specifying the I/O data. 

The following notes define the functions of 
unformatted I/O statements. 

1. Unformatted READ/WRITE statements perform 
memory-image transmission of data with no data 
conversion or editing. 

2. The amount of data transmitted corresponds to 
the number of variables in the list k. 
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The total length of the list of variable names 
in an unformatted READ must not be longer than 
the record length. If the logical record 
length and the length of the list are the same, 
the entire record is read. If the length of 
the list is shorter than the logical record 
length the unread items in the record are 
skipped. 



The WRITE (a) k 
record. 



statement writes one logical 



A logical record may extend across more than 
one physical record. 



8.3 DISK FILE I/O 

A READ or WRITE to a 
automatically OPENs the 
remains open until closed 
(see Section 8.4) or 
termination. 



disk file (LUN 6-10) 
file for I/O. The file 
by an ENDFILE command 
until normal program 



NOTE 

Exercise caution when doing sequential 
output to disk files. If output is done to 
an existing file, the existing file will be 
deleted and replaced with a new file of the 

same name. 



8.3.1 RANDOM DISK I/O 



SEE ALSO SECTION 3 OF YOUR MICROSOFT FORTRAN USER'S 
MANUAL. 

Some versions of FORTRAN- 80 also provide random 
disk I/O. For random disk access, the record 
number is specified by using the REC=n option in 
the READ or WRITE statement. For example: 

I = 10 

WRITE (6,20,REC=I,ERR=50) X, Y, Z 



This program segment writes record 10 on LUN 6. If 
a previous record 10 exists, it is written over, 
If no record 10 exists, the 



file is extended to 
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create one. Any attempt to read a non-existent 
record results in an I/O error. 

In random access files, the record length varies 
with different versions of FORTRAN. See Section 3 
of your Microsoft FORTRAN User's Manual. It is 
recommended that any file you wish to read randomly 
be created via FORTRAN (or Microsoft BASIC) random 
access statements. Files created this way (using 
either binary or formatted WRITE statements) will 
zero-fill each record to the proper length if the 
data does not fill the record. 

Any disk file that is OPENed by a READ or WRITE 
statement is assigned a default filename that is 
specific to the operating system. See also Section 
3 of the FORTRAN User's Manual. 



8.3.2 OPEN SUBROUTINE 

Alternatively, a file may be OPENed using the OPEN 
subroutine. LUNs 1-5 may also be assigned to disk 
files with OPEN. The OPEN subroutine allows the 
program to specify a filename and device to be 
associated with a LUN. 

An OPEN of a non-existent file creates a null file 
of the appropriate name. An OPEN of an existing 
file followed by sequential output deletes the 
existing file. An OPEN of an existing file 
followed by an input allows access to the current 
contents of the file. 

The form of an OPEN call varies under different 
operating systems. See your Microsoft FORTRAN 
User's Manual, Section 3. 

8 . 4 AUXILIARY* I/O STATEMENTS 

Three auxiliary I/O statements are provided: 

BACKSPACE u 
REWIND u 
ENDFILE u 

The actions of all three statements depend on the 
LUN with which they are used (see Appendix B) . 
When the LUN is for a terminal or line printer, the 
three statements are defined as no-ops. 

When the LUN is for a disk drive, the ENDFILE and 
REWIND commands allow further program control of 
disk files. ENDFILE u closes the file associated 
with LUN u. REWIND u closes the file associated 
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C 



with LUN u, then opens it again. BACKSPACE is not 
implemented at this time, and therefore causes an 
error if used. 



8.5 



ENCODE/DECODE 



ENCODE and DECODE statements transfer data, 
according to format specifications, from one 
section of memory to another. DECODE changes data 
from ASCII format to the specified format. ENCODE 
changes data of the specified format into ASCII 
format. The two statements are of the form: 

ENCODE ( A, F) K 
DECODE (A, F) K 

where; 

A is an array name 

F is FORMAT statement number 

K is an I/O List 

DECODE is analogous to a READ statement, since it 
causes conversion from ASCII to internal format. 
ENCODE is analogous to a WRITE statement, causing 
conversion from internal formats to ASCII. 
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NOTE 

Care should be taken that the array A is 
always large enough to contain all of the 
data being processed. There is no check 
for overflow . An ENCODE operation which 
overflows the array will probably wipe out 
important data following the array. A 
DECODE operation which overflows will 
attempt to process the data following the 
array. 

8.6 INPUT/OUTPUT LIST SPECIFICATIONS 

Most forms of READ/WRITE statements may contain an 
ordered list of data names which identify the data 
to be transmitted. The order in which the list 
^ items appear must be the same as that in which the 
-. ' corresponding data exists (Input) , or will exist 
(Output) in the external I/O medium. 

Lists have the following form: 

ml ,m2 , . . . ,mn 

where the mi are list items separated by commas, as 
shown. 

8.6.1 LIST ITEM TYPES 

A list item may be a single datum identifier or a 
multiple data identifier. 

1. A single datum identifier item is the name of a 
variable or array element. One or more of 
these items may be enclosed in parentheses 
without changing their intended meaning. 

Examples : 

A 

C(26,1) ,R,K,D, (I, J) 

B, 1(10, 10) ,S, (R,K) ,F(1,25) 



NOTE 

The entry (I, J) defines two items in 
list while (26,1) is a subscript. 



4*£.£«3wjw- 
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( 



2. Multiple data identifier items are in two 
forms : 

a. An array name appearing in a list without 
subscript (s) is considered equivalent to the 
listing of each successive element of the 
array. 

Example; 

If B is a two dimensional array, the list item 
B is equivalent to: B ( 1 , 1 ) ,B (2 , 1 ) ,B (3 , 1 ) . . . . , 
B(1 ,2) ,B(2,2) .. . ,B(j,k) . 

where j and k are the subscript limits of B. 



( 



b. DO-implied items are lists of one or more 
single datum identifiers or other DO-implied 
items followed by a comma 
expression of the form: 



character and an 



i = m1,m2,m3 or i = ml ,m2 

and enclosed in parentheses. 

The elements i,m1,m2,m3 have the same 
as defined for the DO statement, 
implication applies to all list items 
in parentheses with the implication. 



meaning 

The DO 

enclosed 



Examples: 

DO-Implied Lists 

(X(I) ,1=1,4) 

(Q(J) ,R(J) ,J=1,2) 

(G(K),K=1,7,3) 

((A(I,J) ,1=3,5) ,J=1,9,4) 



(R(M) ,M=1,2) ,I,ZAP(3) 
(R(3) ,T(I),I=1,3) 



Equivalent Lists 

X(1) ,X(2) ,X(3) ,X(4) 
Q(1),R(1) ,Q(2) ,R(2) 
G(1) ,G(4) ,G(7) 
A(3,1) ,A(4,1) ,A(5,1) 
A(3,5) ,A(4,5) ,A(5,5) 
A(3,9) ,A(4,9) ,A(5,9) 
R(1) ,R(2) ,I,ZAP(3) 
R(3) ,T(1),R(3) ,T(2) , 
R(3) ,T(3) 



( 



matrix, for example, 
an order different from 
appear in storage. The 
storage in the order 
A(3,1) ,A(1,2),A(2,2) ,A(3,2), 
A(1,3),A(2,3),A(3,3). By specifying the 
transmission of the array with the DO-implied 
list item ((A(I,J),J=1,3),I=1,3), the order of 
transmission is: 



Thus, the elements of a 
may be transmitted in 
the order in which they 
array A (3, 3) occupies 
A(1,1) ,A(2,1) 



HUs*!*" 
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A(1,1) ,A(1,2) ,A(1,3) ,A(2,1) ,A(2,2), 
A(2,3) ,A(3,1) ,A(3,2) ,A(3,3) 



8 ' 6 * 2 SPECIAL NOTES ON LIST SPECIFICATIONS 

1. The ordering of a list is from left to right 
with repetition of items enclosed in 
parentheses (other than as subscripts) when 
accompanied by controlling DO-implied index 
parameters. 

2. Arrays are transmitted by the appearance of the 
array name (unsubscripted) in an input/output 
list. 

3. Constants may appear in an input/output list 
only as subscripts or as indexing parameters. 

4. For input lists, the DO- implying elements i, 
ml , m2 and m3 may not appear within the 
parentheses as list items. 



Examples; 

1. READ (1,20) (I,J,A(I) ,1=1, J, 2) is not allowed 

2. READ(1,20)I,J, (A(I) ,1=1, J, 2) is allowed 

3. WRITE(1,20) (I,J,A(I) ,1=1, J, 2) is allowed 
Consider the following examples: 

DIMENSION A (25) 

A'(1) = 2.1 
A(3) = 2.2 
A(5) = 2.3 
J = 5 

WRITE (1,20) J, (I,A(I) ,1=1, J, 2) 
the output of this WRITE statement is 



1 . Any number of items may appear in a single 
list. 



:;;„.„ „J 



c 
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2. In a formatted transmission (READ(u,f)k, 
WRITE (u,f)k) each item must have the correct 
type as specified by a FORMAT statement. 

8.7 FORMAT STATEMENTS 

FORMAT statements are non-executable, generative 
statements used in conjunction with formatted READ 
and WRITE statements. They specify conversion 
methods and data editing information as the data is 
transmitted between computer storage and external 
media representation. 

FORMAT statements require statement labels for 
reference (f) in the READ(u,f)k or WRITE (u,f)k 
statements. 

The general form of a FORMAT statement is as 
follows: 

n FORMAT (s1 ,s2, . . . , sn/s 1 * ,s2* , . . . ,sn'A • •) 

where n is the statement label and each si is a 
field descriptor. The word FORMAT and the 
parentheses must be present as shown. The slash 
(/) and comma (,) characters are field separators 
and are described in a separate subparagraph. The 
field is defined as that part of an external record 
occupied by one transmitted item. 

8.7.1 FIELD DESCRIPTORS 

Field descriptors describe the sizes of data fields 
and specify the type of conversion to be exercised 
upon each transmitted datum. The FORMAT field 
descriptors may have any of the following forms: 

Descriptor Classification 

rFw.d 

rGw . d 

rEw.d Numeric Conversion 

rDw.d 
rlw 

rLw Logical Conversion 

rAw 

nHh1h2...hn Hollerith Conversion 



•1112. ..In' 



nX 



Spacing Specification 



mP Scaling Factor 
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whefe : 

1. w and n are positive integer constants defining 
the field width (including digits, decimal 
points, algebraic signs) in the external data 
representation. 

2. d is an integer specifying the number of 
fractional digits appearing in the external 
data representation. 

3. The characters F, G, E, D, I, A and L indicate 
the type of conversion to be applied to the 
items in an input/output list. 

4. r is an optional, non-zero integer indicating 
that the descriptor will be repeated r times. 

5. The hi and li are characters from the FORTRAN 
character set. 

6. m is an integer constant (positive, negative, 
or zero) indicating scaling. 



8.7.2 NUMERIC CONVERSIONS 

Input operations with any of the numeric 
conversions will allow the data to be represented 
in a "Free Format"; i.e., commas may be used to 
separate the fields in the external representation. 

F-type conversion 

Form: Fw.d 

Real or Double Precision type data are processed 
using this conversion, w characters are processed 
of which d are considered fractional. 

F-output 

Values are converted and output as minus sign (if 
negative) , followed by the integer portion of the 
number, a decimal point and d digits of the 
fractional portion of the number. If a value does 
not fill the field, it is right justified in the 
field and enough preceding blanks to fill the field 
are inserted. If a value requires more field 
positions than allowed by w, the first w-1 digits 
of the value are output, preceded by an asterisk. 



c 
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F-Output Examples: 



FORMAT 


Internal 


Output 


Descriptor 


Value 


(b=blank) 


F10.4 


368.42 


bb362.4200 


F7.1 


-4786.361 


-4786.4 


F8.4 


8.7E-2 


bbO.0375 


F6.4 


4739.76 


*.7600 


F7.3 


-5.6 


b-5.600 



* Note the loss of leading digits in the 4th line 
above. 

F-Input 

(See the description under E- Input below. ) 

E-type Conversion 

Form: Ew.d 

Real or Double Precision type data are processed 
using this conversion, w characters are processed 
of which d are considered fractional. 

E-Output 

Values are converted, rounded to d digits, and 
output as : 

1. a minus sign (if negative), 

2. a zero and a decimal point, 

3. d decimal digits, 

4. the letter E, 

5. the sign of the exponent (minus or blank), 

6. two exponent digits, 

in that order. The values as described are right 
justified in the field w with preceding blanks to 
fill the field if necessary. The field width w 
should satisfy the relationship: 

w > d + 7 

Otherwise significant characters may be lost. Some 
E-Output examples follow: 
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FORMAT 
Descriptor 


Internal 
Value 


Output 
(b=blank) 


E12.5 
E14.7 
E13.4 
E8.2 


76.573 
-32672.354 
-0.0012321 
76321.73 


bb.76573Eb02 
-b.3267235Eb05 
bb-b.1232E-02 
b.76Eb05 


E-Input 







Data values which are to be processed under E, F, 
or G conversion can be a relatively loose format in 
the external input medium. The format is identical 
for either conversion and is as follows? 

1. Leading spaces (ignored) 

2. A + or - sign (an unsigned input is assumed to 
be positive) 

3. A string of digits 

4. A decimal point 

5. A second string of digits 

6. The character E 

7. A + or - sign 

8. A decimal exponent 



Each item in the list above is optional; 
following conditions must be observed: 



but the 



1. If FORMAT items 3 and 5 (above) are present, 
then 4 is required. 



2. If FORMAT item 8 is present, then 6 
both are required. 



or 



or 



3. All non-leading spaces are considered zeros. 

Input data can be any number of digits in length, 
and correct magnitudes will be developed, but 
precision will be maintained only to the extent 
specified in Section 3 for Real data. 



' » 
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E- and F- and G- Input Examples: 

FORMAT Input Internal 

DescriptDr (b=blank) Value 

E10.3 +0.23756+4 +2375.60 

E10.3 bbbbb17631 +17.631 

G8.3 b1628911 +1628.911 

F12.4 bbbb-6321132 -632.1131 



Note in the above examples that if no decimal point 
is given among the input characters, the d in the 
FORMAT specification establishes the decimal point 
in conjunction with an exponent, if given. If a 
decimal point is included in the input characters, 
the d specification is ignored. 

The letters E, F, and G are interchangeable in the 
input format specifications. The end result is the 
same. 



D-Type Conversions 

D-Input and D-Output are identical to E-Input and 
E-Output except the exponent may be specified with 
a "D" instead of an "E." 



G-Type Conversions 

Form: Gw.d 

Real or Double Precision type data are processed 
using this conversion. w characters are processed 
of which d are considered significant. 

G-Input: 

(See the description under E-Input) 

G-Output: 

The method of output conversion is a function of 
the magnitude of the number being output. Let n be 
the magnitude of the number. The following table 
shows how the number will be output: 
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Magnitude 
. 1 <= n 1 
1 <= n 10 



Equivalent Conversion 
F(w-4) .d,4X 
F(w-4) . (d-1) ,4X 



10 d " 2 <= n < 10 d_1 



F(w-4) . 1,4X 



10 d " 1 <= n < 10 d 



Otherwise 



F(w-4) .0,4X 
Ew.d 



I-Conversions 

Form: Iw 

Only Integer data may be converted by this form of 
conversion, w specifies field width. 

I-Output: 

Values are converted to Integer constants. 
Negative values are preceded by a minus sign. If 
the value does not fill the field, it is right 
justified in the field and enough preceding blanks 
to fill the field are inserted. If the value 
exceeds the field width, only the least significant 
w-1 characters are output preceded by an asterisk. 



Output 
(b=blank) 

bbb2 81 

-23261 

126 

-226 



A field of w characters is input and converted to 
internal integer format. A minus sign may precede 
the integer digits. If a sign is not present, the 
value is considered positive. 

Integer values in the range -32768 to 32767 are 
accepted. Non-leading spaces are treated as zeros. 



Examples: 




FORMAT 


Internal 


Descriptor 


Value 


16 


+281 


16 


-23261 


13 


126 


14 


-226 


I-Input: 
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Examples ; 






Format 
Descriptor 


Input 
(b=blank) 


Internal 
Value 


14 
14 
17 
14 


b124 
-124 
bb6732b 
1b2b 


124 
-124 
67320 
1020 



8.7.3 HOLLERITH CONVERSIONS 

A-Type Conversion 

The form of the A conversion is as follows: 

Aw 

This descriptor causes unmodified Hollerith 
characters to be read into or written from a 
specified list item. 

The maximum number of actual characters which may 
be transmitted between internal and external 
representations using Aw is four times the number 
of storage units in the corresponding list item 
(i.e., 1 character for logical items, 2 characters 
for Integer items, 4 characters for Real items and 
8 characters for Double Precision items) . 

A-Output: 

If w is greater than 4n (where n is the number of 
storage units required by the list item) , the 
external output field will consist of w-4n blanks 
followed by the 4n characters from the internal 
representation. If w is less than 4n, the external 
output field will consist of the leftmost w 
characters from the internal representation. 



Examples: 






Format 


Internal 


Type 


Descriptor 






A1 


A1 


Integer 


A2 


AB 


Integer 


A3 


ABCD 


Real 


A4 


ABCD 


Real 


A7 


ABCD 


Real 



Output 
(b=blanks) 

A 

AB 

ABC 

ABCD 

bbbABCD 



A-Input : 

If w is greater than 4n (where n is the number of 
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storage units required by the corresponding list 
item) , the rightmost 4n characters are taken from 
the external input field. If w is less than 4n, 
the w characters appear left justified with w-4n 
trailing blanks in the internal representation. 



Examples : 








Format 
Descriptor 


Input 
Characters 


Type 


Internal 
(b=blanks) 


A1 
A3 
A4 
A1 
A7 


A 

ABC 

ABCD 

A 

ABCDEFG 


Integer 

Integer 

Integer 

Real 

Real 


Ab 

AB 

AB 

Abbb 

DEFG 


H-Con vers ion 








The forms of 


H conversion are 


as follows s 




nHh1h2 . , 


• .hn 






«h1h2.., 


,hn' 







These descriptors process Hollerith character 
strings between the descriptor and the external 
field, where each h represents any character from 
the ASCII character set. 



NOTE 

Special consideration is required if an 
apostrophe ( ' ) is to be used within the 
literal string in the second form. An 
apostrophe character within the string is 
represented by two successive apostrophes. 
See the examples below. 



H-Output: 

The n characters hi, are placed in the external 
field. In the nHh1h2...hn form the number of 
characters in the string must be exactly as 
specified by n. Otherwise, characters from other 
descriptors will be taken as part of the string. 
In both forms, blanks are counted as characters. 
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Examples : 

Format 
Descriptor 

1HA or 

8HbSTRINGb or 
11HX(2,3)=12.0 or 
12HIbSH0ULDN'T or 

H-Input 



'A' 

'bSTRINGb' 
'X(2,3)=12.0' 
•ibSHOULDN' 'T« 



Output 
(b=blanks) 

A 

bSTRINGb 
X(2,3) = 12.0 
IbSHOULDN 'T 



The n characters of the string hi are replaced by 
the next n characters from the input record. This 
results in a new string of characters in the field 
descriptor. 



FORMAT 
Descriptor 



4H1234 

7HbbFALSE 

6Hbbbbbb 



or 
or 
or 



•1234' 
'bbFALSE' 
' bbbbbb ' 



Input 
(b=blank) 

ABCD 

bFALSEb 

MATRIX 



Resultant 
Descriptor 

4 H ABCD or ' 
7HbFALSEb or 
6HMATRIX or 



'ABCD' 



• bFALSEb ' 
•MATRIX' 



8.7.4 LOGICAL CONVERSIONS 

The form of the logical conversion is as follows: 

Lw 
L-Output : 

If the value of an item in an output _ list 
corresponding to this descriptor is 0, an F will be 
output; otherwise, a T will be output. If w is 
greater than 1, w-1 leading blanks precede the 
letters. 



( 



Examples : 






FORMAT 
Descriptor 


Internal 
Value 


Output 
(b=blank) 


L1 
L1 
L5 
L7 


II A A II 
O V V O 

o o 


F 

T 

bbbbT 

bbbbbbF 


L-Input 







The external representation occupies w positions. 
It consists of optional blanks followed by a "T" or 
"F" , followed by optional characters. 
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8.7.5 X DESCRIPTOR 

The form of X conversion is as follows: 
nX 

This descriptor causes no conversion to occur, nor 
does it correspond to an item in an input/output 
list. When used for output, it causes n blanks to 
be inserted in the output record. Under input 
circumstances, this descriptor causes the next n 
characters of the input record to be skipped. 

Output Examples; 

FORMAT Statement Output 

(b=blanks) 

3 FORMAT (1HA,4X,2HBC) AbbbbBC 
7 FORMAT (3X,4HABCD,1X) bbbABCDb 

Input Examples; 

FORMAT Statement Input String Resultant Input 

10 FORMAT (F4.1,3X,F3.0) 12.5ABC120 12.5,120 
5 FORMAT (7X,I3) 1234567012 012 

8.7.6 P DESCRIPTOR 

The P descriptor is used to specify a scaling 
factor for real conversions (F, E, D, G) . The form 
is nP where n is an integer constant (positive, 
negative, or zero). 

The scaling factor is automatically set to zero at 
the beginning of each formatted I/O call (each READ 
or WRITE statement). If a P descriptor is 
encountered while scanning a FORMAT, the scale 
factor is changed to n. The scale factor remains 
changed until another P descriptor is encountered 
or the I/O terminates. 

Effects of Scale Factor on Input; 

During E, F, or G input the scale factor takes 
effect only if no exponent is present in the 
external representation. In that case, the 
internal value will be a factor of 10**n less than 
the external value (the number will be divided by 
10**n before being stored). 



( 



t 
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Effect of Scale Factor on Output: 

E~Output, D-Output: 

The coefficient is shifted left n places relative 
to the decimal point, and the exponent is reduced 
by n (the value remains the same) . 

F-Output : 

The external value will be 10**n times the internal 
value. 

G-Output : 

The scale factor is ignored if the internal value 
is small enough to be output using F conversion. 
Otherwise, the effect is the same as for E output. 

8.7.7 SPECIAL CONTROL FEATURES OF FORMAT STATEMENTS 

8.7.7.1 Repeat Specifications 

1. The E, F, D, G, I, L and A field descriptors 
may be indicated as repetitive descriptors by 
using a repeat count r in the form rEw.d, 
rFw.d, rGw.d, rlw, rLw, rAw. The following 
pairs of FORMAT statements are equivalent: 

66 FORMAT (3F8.3,F9.2) 
C IS EQUIVALENT TO: 

66 FORMAT (F8 . 3 ,F8 . 3 ,F8 . 3 ,F9 . 2 ) 

14 FORMAT (2I3,2A5,2E10.5) 
C IS EQUIVALENT TO: 

14 FORMAT (I3,I3,A5,A5,E10.5,E10.5) 



Repetition of a group of field descriptors is 
accomplished by enclosing the group in 
parentheses preceded by a repeat count. 
Absence of a repeat count indicates a count of 
one. Up to two levels of parentheses, 
including the parentheses required by the 
FORMAT statement, are permitted. 

Note the following equivalent statements: 
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22 FORMAT ( 13 , 4 (F6 . 1 , 2X) ) 
C IS EQUIVALENT TO: 

22 FORMAT (13 ,F6 . 1 , 2X,F6 . 1 , 2X,F6 . 1 , 2X, 
1 F6.1,2X) 



3. Repetition of FORMAT descriptors is also 
initiated when all descriptors in the FORMAT 
statement have been used but there are still 
items in the input/output list that have not 
been processed. When this occurs the FORMAT 
descriptors are re-used starting at the first 
opening parenthesis in the FORMAT statement. A 
repeat count preceding the parenthesized 
descriptor (s) to be re-used is also active in 
the re-use. This type of repetitive use of 
FORMAT descriptors terminates processing o, the 
current record and initiates the processing of 
a new record each time the re-use begins. 
Record demarcation under these circumstances is 
the same as in the paragraph 8.7.7.2 below. 



Input Example: 

DIMENSION A(100) 
READ (3,13) A 



13 FORMAT (5F7.3) 

In this example, the first 5 quantities from each 
of 20 records are input and assigned to the array 
elements of the array A. 

Output Example: 



WRITE (6,12)E,F,K,L,M,KK,LL,MM,K3,LE, 
1 M3 



12 FORMAT (2F9.4, (317) ) 

In this example, three records are written. Record 
1 contains E, F, K, L and M. Because the 
descriptor 317 is reused twice, Record 2 contains 
KK, LL and MM and Record 3 contains K3, L3 and M3. 
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8.7.7.2 Field Separators 

Two adjacent descriptors must be separated in the 
FORMAT statement by either a comma or one or more 
slashes. 

Example; 

2H0K/F6.3 or 2H0K,F6.3 

The slash not only separates field descriptors, but 
it also specifies the demarcation of formatted 
records. 

Each slash terminates a record and sets up the next 
record for processing. The remainder of an input 
record is ignored; the remainder of an output 
record is filled with blanks. Successive slashes 
(///.../) cause successive records to be ignored on 
input and successive blank records to be written on 
output. 

Output example: 

DIMENSION A(100),J(20) 



WRITE (7,8) J, A 
8 FORMAT (10I7/10I7/50F7.3/50F7.3) 

In this example, the data specified by the list of 
the WRITE statement are output to unit 7 according 
to the specifications of FORMAT statement 8. Four 
records are written as follows: 

Record 1 Record 2 Record 3 Record 4 

j(1) J(11) A(1) A (51) 

J(2) J(12) A(2) A(52) 



J(10) J(20) A(50) A(100) 

Input Example: 

DIMENSION B(10) 



READ (4,17) B 
17 FORMAT(F10.2/F10.2///8F10.2) 

In this example, the two array elements B(1) and 
B(2) receive their values from the first data 
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fields of successive records (the remainders of the 
two records are ignored) . The third and fourth 
records are ignored and the remaining elements of 
the array are filled from the fifth record. 



8.7.8 FORMAT CONTROL, LIST SPECIFICATIONS AND RECORD 
DEMARCATION 

The following relationships and interactions 
between FORMAT control, input/output lists and 
record demarcation should be noted: 

1. Execution of a formatted READ or WRITE 
statement initiates FORMAT control. 



2. The conversion performed on data depends on 
information jointly provided by the elements in 
the input/output list and field descriptors in 
the FORMAT statement. 

3. If there is an input/output list, at least one 
descriptor of types E, F, D, G, I, L or A must 
be present in the FORMAT statement. 

4. Each execution of a formatted READ statement 
causes a new record to be input. 

5. Each item in an input list corresponds to a 
string of characters in the record and to a 
descriptor of the types E, F, G, I, L or A in 
the FORMAT statement. 

6. H and X descriptors communicate information 
directly between the external record and the 
field descriptors without reference to list 
items . 

7. On input, whenever a slash is encountered in 
the FORMAT statement or the FORMAT descriptors 
have been exhausted and re-use of descriptors 
is initiated, processing of the current record 
is terminated and the following occurs: 

a. Any unprocessed characters in the record 
are ignored. 

b. If more input is necessary to satisfy 
list requirements, the next record is 
read. 
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8. A READ statement is terminated when all items 
in the input list have been satisfied if: 

a. The next FORMAT descriptor is E, F, G, I, 
L or A. 

b. The FORMAT control has reached the last 
outer right parenthesis of the FORMAT 
statement. 

If the input list has been satisfied, but the 
next FORMAT descriptor is H or X, more data are 
processed (with the possibility of new records 
being input) until one of the above conditions 
exists. 

9. If FORMAT control reaches the last right 
parenthesis of the FORMAT statement but there 
are more list items to be processed, all or 
part of the descriptors are reused. (See item 
3 in the description of Repeat Specifications, 
sub-paragraph 8.7.7.1) 

10. When a Formatted WRITE statement is executed, 
records are written each time a slash is 
encountered in the FORMAT statement or FORMAT 
control has reached the rightmost right 
parenthesis. The FORMAT control terminates in 
one of the two methods described for READ 
termination in 8 above. Incomplete records are 
filled with blanks to maintain record lengths. 



8.7.9 FORMAT CARRIAGE CONTROL 

The first character of every formatted output 
record is used to convey carriage control 
information to the output device, and is therefore 
never printed. The carriage control character 
determines what action will be taken before the 
line is printed. The options are as follows: 

Control Character Action Taken Before Printing 

Skip 2 lines 

1 Insert Form Feed 
+ No advance 
Other Skip 1 line 



8.7.10 FORMAT SPECIFICATIONS IN ARRAYS 

The FORMAT reference, f, of a formatted READ or 
WRITE statement (See 8.1) may be an array name 
instead of a statement label. If such reference is 
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made, at the time of execution of the READ/WRITE 
statement the first part of the information 
contained in the array, taken in natural order, 
must constitute a valid FORMAT specification. The 
array may contain non-FORMAT information following 
the right parenthesis that ends the FORMAT 
specification. 

The FORMAT specification which is to be inserted in 
the array has the same form as defined for a FORMAT 
statement (i.e., it begins with a left parenthesis 
and ends with a right parenthesis) . 

The FORMAT specification may be inserted in the 
array by use of a DATA initialization statement, or 
by use of a READ statement together with an Aw 
FORMAT . Example; 

Assume the FORMAT specification 

(3F10. 3,416) 

or a similar 12 character specification is to be 
stored into an array. The array must allow a 
minimum of 3 storage units. 

The FORTRAN coding below shows the various methods 
of establishing the FORMAT specification and then 
referencing the array for a formatted READ or 

WRITE. 



c 
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C DECLARE A REAL ARRAY 

DIMENSION A(3), B(3), M(4) 
C INITIALIZE FORMAT WITH DATA STATEMENT 

DATA A/' (3F1','0.3,',MI6) '/ 



C READ DATA USING FORMAT SPECIFICATIONS 
C IN ARRAY A 

READ(6,A) B, M 

C DECLARE AN INTEGER ARRAY 

DIMENSION IA(4), B(3), M(4) 



C READ FORMAT SPECIFICATIONS 

READ (7,15) IA 
C FORMAT FOR INPUT OF FORMAT SPECIFICATIONS 
15 FORMAT (4A2) 



C READ DATA USING PREVIOUSLY INPUT 
C FORMAT SPECIFICATION 
READ (7,IA) B,M 



I 
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SECTION 9 
FUNCTIONS AND SUBPROGRAMS 

The FORTRAN language provides a means for defining and using 
often needed programming procedures ^that the statejent 
or statements of the procedures need appear in a Program 
only once but may be referenced and brought into a th « i°^ c ^ 
execution sequence of the program whenever and as often as 
needed. 

These procedures are as follows; 

1. Statement functions. 

2. Library functions. 

3. FUNCTION subprograms. 

4. SUBROUTINE subprograms. 

Each of these procedures has its own unique requirements for 
reference and defining purposes These re ^ rem ^ c tion! 
discussed in subsequent paragraphs of this ^tion^ 
However, certain features are common to the wh °^ group or 
to two or more of the procedures. These common features are 
as follows: 



1. Each of these procedures is referenced by its name 
which, in all cases, is one to six alphanumeric 
characters of which the first is a letter. 

2. The first three are designated as "functions" and 
are alike in that: 

1. They are always single valued (i.e. , they 
return one value to the program unit from which 
they are referenced) . 

2. They are referred to by an expression 
containing a function name. 

3. They must be typed by type specification 
statements if the data type of the 
single-valued result is to be different from 
that indicated by the pre-defined convention. 

3. FUNCTION subprograms and SUBROUTINE subprograms are I ) 
considered program units. 
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( In the following descriptions of these procedures, the term 

calling program means the program unit or procedure in whicn 
a reference to a procedure is made, and the term caiiea 
program" means the procedure to which a reference is made. 

9,1 THE PROGRAM STATEMENT 

The PROGRAM statement provides a means of 
specifying a name for a main program unit. The 
form of the statement is: 

PROGRAM name 

If present, the PROGRAM statement must appear 
before any other statement in the program unit. 
The name consists of 1-6 alphanumeric characters, 
the first of which is a letter. If no PROGRAM 
statement is present in a main program, the 
compiler assigns a name of $MAIN to that program. 

9.2 STATEMENT FUNCTIONS 

Statement functions are defined by a s j n 9j;® 
( arithmetic or logical assignment statement and are 

^ relevant only to the program unit in which they 

appear. The general form of a statement function 

is as follows: 

f (a1 ,a2, . . .an) = e 

where f is the function name, the ai are dummy 
arguments and e is an arithmetic or logical 
expression. 

Rules for ordering, structure and use of statement 
functions are as follows: 

1. Statement function definitions, if they exist 
in a program unit, must precede all executable 
statements in the unit and follow all 
specification statements. 

2 The ai are distinct variable names or array 
elements, but, being dummy variables, they may 
have the same names as variables of the same 
type appearing elsewhere in the program unit. 

3. The expression e is constructed according to 

the rules in SECTION 4 and may contain only 

( references to the dummy foments and 

non-Literal constants, variable and array 
element references, utility and mathematical 
function references and references to 
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previously defined statement functions. 

4. The type of any statement function name or 
argument that differs from its pre-defined 
convention type must be defined by a type 
specification statement. 

5. The relationship between f and e must conform 
to the replacement rules in Section 5. 

6. A statement function is called by its name 
followed by a parenthesized list of arguments. 
The expression is evaluated using the arguments 
specified in the call, and the reference is 
replaced by the result. 

7. The ith parameter in every argument list must 
agree in type with the ith dummy in the 
statement function. 

The example below shows a statement function and a 
statement function call. 

C STATEMENT FUNCTION DEFINITION 

C 

FUNC1 (A,B,C,D) = ((A+B)**C)/D 



C STATEMENT FUNCTION CALL 

C 

A12=A1-FUNC1 (X,Y,Z7,C7) 



9.3 LIBRARY FUNCTIONS 

Library functions are a group of utility and 
mathematical functions which are "built-in" to the 
FORTRAN* system. Their names a pre-defined to the 
Processor and automatically typed. The functions 
are listed in Tables 9-1 and 9-2. In the tables, 
arguments are denoted as a1 ,a2, . . . ,an, if more than 
one argument is required; or as a if only one is 
required. 

A library function is called when its name is used 
in an arithmetic expression. Such a reference 
takes the following form: 

f (a1 ,a2, . . .an) 

where f is the name of the function and the ai are 
actual arguments. The arguments must agree in 
type, number and order with the specifications 
indicated in Tables 9-1 and 9-2. 
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In addition to the functions listed in 9-1 and 9-2, 
four additional library subprograms are provided to 
enable direct access to the 8080 (or Z80) hardware. 
These are: 

PEEK, POKE, INP, OUT 

PEEK and INP are Logical functions; POKE and OUT 
are subroutines. PEEK and POKE allow direct access 
to any memory location. PEEK (a) returns the 
contents of the memory location specified by a. 
CALL POKE(a1,a2) causes the contents of the memory 
location specified by a1 to be replaced by the 
contents of a2. INP and OUT allow direct access to 
the I/O ports. INP (a) does an input from port a 
and returns the 8-bit value input. CALL OUT(a1,a2) 
outputs the value of a2 to the port specified by 
a1. 

Examples : 

A1 = B+FLOAT (17) 

MAGNI = ABS(KBAR) 

PDIF = DIM(C,D) 

S3 = SIN(T12) 

ROOT = (-B+SQRT(B**2-4.*A*C) )/ 
1 (2.*A) 
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TABLE 9-1 



Intrinsic Functions 



Function Name Definition 



ABS 

IABS 

DABS 



AINT 

INT 

IDINT 

AMOD 
MOD 

AMAXO 

AMAX1 

MAXO 

MAX1 

DMAX1 

AMINO 

AMIN1 

MINO 

MINI 

DMIN1 

FLOAT 



IFIX 



SIGN 

ISIGN 

DSIGN 



DIM 
IDIM 

SNGL 

DBLE 



|a| 



Sign of a times lar- 
gest integer <= |a| 



a1 (mod a2) 



Max (a1 ,a2 , . . . ) 



Min (a1 ,a2 , . . . ) 



Conversion from 
Integer to Real 

Conversion from 
Real to Integer 

Sign of a2 times |al| 



a1 - Min(a1 ,a2) 



Type 
Argument 


s 
Function 


Real 


Real 


Integer 
Double 


Integer 

Double 


Real 


Real 


Real 
Double 


Integer 
Integer 


Real 


Real 


Integer 


Integer 


Integer 
Real 


Real 
Real 


Integer 

Real 

Double 


Integer 
Integer 
Double 


Integer 
Real 


Real 
Real 


Integer 

Real 

Double 


Integer 
Integer 
Double 


Integer 


Real 


Real 


Integer 


Real 


Real 


Integer 
Double 


Integer 
Double 


Real 


Real 


Integer 


Integer 


Double 


Real 


Real 


Double 
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TABLE 9-2 



Basic External Functions 



Number 
of 
Name Arguments 


Definition 


Argument 


Type 

Function 


EXP 
DEXP 




e**a 




Real 
Double 




Real 
Double 


ALOG 
DLOG 




In (a) 




Real 
Double 




Real 
Double 


ALOG 10 
DLOG 10 




log 10 (a) 




Real 
Double 




Real 
Double 


SIN 
DSIN 




sin (a) 




Real 
Double 




Real 
Double 


COS 
DCOS 




cos (a) 




Real 
Double 




Real 
Double 


TANH 




tanh (a) 




Real 




Real 


SQRT 
DSQRT 




(a) ** 1/2 




Real 
Double 




Real 
Double 


ATAN 
DATAN 




arctan (a) 




Real 
Double 




Real 
Double 


ATAN 2 
DATAN 2 


2 
2 


arctan (a1/a2) 


Real 
Double 




Real 
Double 


DMOD 


2 


a1 (mod a2) 




Double 




Double 
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9.4 FUNCTION SUBPROGRAMS 

A program unit which begins with a FUNCTION 
statement is called a FUNCTION subprogram. 

A FUNCTION statement has one of the following 

forms : 

t FUNCTION f (a1,a2,. ..an) 

or 

FUNCTION f (a1,a2,...an) 

where : 

1. t is either INTEGER, REAL, DOUBLE PRECISION or 
LOGICAL or is empty as shown in the second 
form. 

2. f is the name of the FUNCTION subprogram. 

3. The ai are dummy arguments of which there must 
be at least one and which represent variable 
names, array names or dummy names of SUBROUTINE 
or other FUNCTION subprograms. 

9.5 CONSTRUCTION OF FUNCTION SUBPROGRAMS 

Construction of FUNCTION subprograms must comply 
with the following restrictions: 

1. The FUNCTION statement must be the first 
statement of the program unit. 

2. Within the FUNCTION subprogram, the FUNCTION 
name must appear at least once on the left side 
6f the equality sign of an assignment statement 
or as an item in the input list of an input 
statement. This defines the value of the 
FUNCTION so that it may be returned to the 
calling program. 

Additional values may be returned to the 
calling program through assignment of values to 
dummy arguments. 



c 
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Example: 

FUNCTION Z7(A,B,C) 

a 

Z7 = 5.MA-B) + SQRT(C) 



C REDEFINE ARGUMENT 
B=B+Z7 



RETURN 



END 



3. The names in the dummy argument list may not appear 
in EQUIVALENCE, COMMON or DATA statements m the 
FUNCTION subprogram. 

4. If a dummy argument is an array name, then an array 
declarator must appear in the subprogram with 
dimensioning information consistant with that in 
the calling program. 

5. A FUNCTION subprogram may contain any defined 
FORTRAN statements other than BLOCK DATA 
statements, SUBROUTINE statements, another FUNCTION 
statement or any statement which references either 
the FUNCTION being defined or another subprogram 
that references the FUNCTION being defined. 

6. The logical termination of a FUNCTION subprogram is 
a RETURN statement and there must be at least one 
of them. 

7. A FUNCTION subprogram must physically terminate 
with an END statement. 



t 
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Example: 

FUNCTION SUM (BARY,I,J) 
DIMENSION BARY (10,20) 
SUM =0.0 
DO 8 K=1 ,1 
D08 M = 1 ,J 
8 SUM = SUM + BARY(K,M) 
RETURN 
END 



9.6 REFERENCING A FUNCTION SUBPROGRAM 

FUNCTION subprograms are called whenever the 
FUNCTION name, accompanied by an argument list, is 
used as an operand in an expression. Such 
references take the following form: 

f (a1 ,a2, . . . ,an) 

where f is a FUNCTION name and the ai are actual 
arguments. Parentheses must be present in the form 
shown . 

The arguments ai must agree in type, order and 
number with the dummy arguments in the FUNCTION 
statement of the called FUNCTION subprogram. They 
may be any of the following: 

1. A variable name. 

2. An array element name. 

3. An array name. 

4. An expression. 

5. A SUBROUTINE or FUNCTION subprogram name. 

6. A Hollerith or Literal constant. 

If an ai is a subprogram name, that name must have 
previously been distinguished from ordinary 
variables by appearing in an EXTERNAL statement and 
the corresponding dummy arguments in the called 
FUNCTION subprograms must be used in subprogram 
references. 

If ai is a Hollerith or Literal constant, the 
corresponding dummy variable should encompass 
enough storage units to correspond exactly to the 
amount of storage needed by the constant. 

When a FUNCTION subprogram is called, program 
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control goes to the first executable statement 
following the FUNCTION statement. 

The following examples show references to FUNCTION 
subprograms . 

Z10 = FT1+Z7 (D,T3,RH0) 
DIMENSION DAT (5, 5) 



S1 = T0T1 + SUM (DAT, 5, 5) 

9.7 SUBROUTINE SUBPROGRAMS 

A program unit which begins with a SUBROUTINE 
statement is called a SUBROUTINE subprogram. The 
SUBROUTINE statement has one of the following 
forms : 

SUBROUTINE s (a1 , a2 , . . . , an) 
or 

SUBROUTINE s 

where s is the name of the SUBROUTINE subprogram 

and each ai is a dummy argument which represents a 

variable or array name or another SUBROUTINE or 
FUNCTION name. 

9.8 CONSTRUCTIO N OF SUBROUTINE SUBPROGRAMS 

1. The SUBROUTINE statement must be the first statement 
of the subprogram. 

2 The SUBROUTINE subprogram name must not appear in 
any statement other than the initial SUBROUTINE 
statement. 

3. The dummy argument names must not appear in 
EQUIVALENCE, COMMON or DATA statements in the 
subprogram. 

4. If a dummy argument is an array name then an array 
declarator must appear in the subprogram _ with 
dimensioning information consistant with that in the 
calling program. 

^ 5 if any of the dummy arguments represent values that 

' are to be determined by the SUBROUTINE subprogram 
and returned to the calling program, these dummy 



( 
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arguments must appear within the subprogram on the 
left side of the equality sign in a replacement 
statement, in the input list of an input statement 
or as a parameter within a subprogram reference. 

6. A SUBROUTINE may contain any FORTRAN statements 
other than BLOCK DATA statements, FUNCTION 
statements, another SUBROUTINE statement, a PROGRAM 
statement or any statement which references the 
SUBROUTINE subprogram being defined or another 
subprogram which references the SUBROUTINE 
subprogram being defined. 

7. A SUBROUTINE subprogram may contain any number of 
RETURN statements. It must have at least one. 

8. The RETURN statement (s) is the logical termination 
point of the subprogram. 

9. The physical termination of a SUBROUTINE subprogram 
is an END statement. 

10. If an actual argument transmitted to a SUBROUTINE 
subprogram by the calling program is the name of a 
SUBROUTINE or FUNCTION subprogram, the correspondxng 
dummy argument must be used in the called SUBROUTINE 
subprogram as a subprogram reference. 



Example: 

C SUBROUTINE TO COUNT POSITIVE ELEMENTS 
C IN AN ARRAY 

SUBROUTINE COUNT P (ARRY , I ,CNT) 

DIMENSION ARRY (7) 

CNT = 

DO 9 J=1,I 

IF (ARRY (J)) 9", 5, 5 
9 CONTINUE 

RETURN 
5 CNT = CNT+1.0 

GO TO 9 

END 



9.9 REFERENCING A SUBROUTINE SUBPROGRAM 

A SUBROUTINE subprogram may be called by using a 
CALL statement. A CALL statement has one of the 
following forms: 

CALL s (a1 ,a2, . . . ,an) 
or 



1 I 



c 



( 
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CALL s 

where s is a SUBROUTINE subprogram name and the ai 
are the actual arguments to be used by the 
subprogram. The ai must agree in type, order and 
number with the corresponding dummy arguments in 
the subprogram-defining SUBROUTINE statement. 

The arguments in a CALL statement must comply with 
the following rules: 

1 . FUNCTION and SUBROUTINE names appearing in the 
argument list must have previously appeared in 
an EXTERNAL statement. 

2. If the called SUBROUTINE subprogram contains a 
variable array declarator, then the CALL 
statement must contain the actual name of the 
array and the actual dimension specifications 
as arguments. 

3. If an item in the SUBROUTINE subprogram dummy 
argument list is an array, the corresponding 
item in the CALL statement argument list must 
be an array. 

When a SUBROUTINE subprogram is called, program 
control goes to the first executable statement 
following the SUBROUTINE statement. 

Example ; 

DIMENSION DATA (10) 



C THE STATEMENT BELOW CALLS THE 

C SUBROUTINE IN THE PREVIOUS PARAGRAPH 

C 

CALL COUNTP(DATA,10,CPOS) 



9 - 10 RETURN FROM FUNCTION AND SUBROUTINE SUBPROGRAMS 

The logical termination of a FUNCTION or SUBROUTINE 
subprogram is a RETURN statement which transfers 
control back to the calling program. The general 
form of the RETURN statement is simply the word 

RETURN 

The following rules govern the use of the RETURN 
statement: 



FORTRAN- 80 Reference Manual Page 94 



1. There must be at least one RETURN statement in 
each SUBROUTINE or FUNCTION subprogram. 

2. RETURN from a FUNCTION subprogram is to the 
instruction sequence of the calling program 
following the FUNCTION reference. 

3. RETURN from a SUBROUTINE subprogram is to the 
next executable statement in the calling 
program which would logically follow the CALL 
statement. 

4. Upon return from a FUNCTION subprogram the 
single-valued result of the subprogram is 
available to the evaluation of the expression 
from which the FUNCTION call was made. 

5. Upon return from a SUBROUTINE subprogram the 
values assigned to the arguments in the 
SUBROUTINE are available for use by the calling 
program. 



Example: 

Calling Program Unit 

CALL SUBR(Z9,B7,R1) 

• 
o 
s 

Called Program Unit 

SUBROUTINE SUBR(A,B,C) 
READ (3,7) B 
A = B**C 
RETURN 
7 FORMAT (F9. 2) 
END 

In this example, Z9 and B7 are made available to 
the calling program when the RETURN occurs. 

9.11 PROCESSING ARRAYS IN SUBPROGRAMS 

If a calling program passes an array name to a 
subprogram, the subprogram must contain the 
dimension information pertinent to the array. A 
subprogram must contain array declarators if any of 
its dummy arguments represent arrays or array 
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elements. 

For example, a FUNCTION subprogram designed to 
compute the average of the elements of any one 
dimension array might be the folowing: 



Calling Program Unit 
DIMENSION Z1 (50) ,Z2 (25] 

A1 = AVG(Z1 ,50) 

A2 = A1-AVG(Z2,25) 



Called Program Unit 

FUNCTION AVG(ARG,I) 
DIMENSION ARG(50) 
SUM =0.0 
DO 20 J=1 ,1 

20 SUM = SUM + ARG(J) 
AVG = SUM/FLOAT (I) 
RETURN 
END 

Note that actual arrays to be processed by the 
FUNCTION subprogram are dimensioned in the calling 
program and the array names and their actual 
dimensions are transmitted to the FUNCTION 
subprogram by the FUNCTION subprogram reference. 
The FUNCTION subprogram itself contains a dummy 
array and specifies an array declarator. 

Dimensioning information may also be passed to the 
subprogram in the paramater list. For example: 



I 
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Calling Program Unit 
DIMENSION A (3, 4, 5) 

CALL SUBR(A,3,4,5) 

e 
a 
• 

END 

Called Program Unit 

SUBROUTINE SUBR (X, I , J,K) 
DIMENSION X(I,J,K) 



RETURN 
END 

It is valid to use variable dimensions only when 
the array name and all of the variable dimensions 
are dummy arguments. The variable dimensions must 
be type Integer. It is invalid to change the 
values of any of the variable dimensions within the 
called program. 



9.12 BLOCK DATA SUBPROGRAMS 

A BLOCK DATA subprogram has as its only purpose the 
initialization of data in a COMMON block during 
loading of a FORTRAN object program. BLOCK DATA 
subprograms begin with a BLOCK DATA statement of 
the following form: 

BLOCK DATA [subprogram-name] 

and end with an END statement. Such subprograms 
may contain only Type, EQUIVALENCE, DATA, COMMON 
and DIMENSION statements and are subject to the 
following considerations: 

1 . If any element in a COMMON block is to be 
initialized, all elements of the block must be 
listed in the COMMON statement even though they 
might not all be initialized. 

2. Initialization of data in more than one COMMON 
block may be accomplished in one BLOCK DATA 
subprogram. 
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3. There may be more than one BLOCK DATA 
subprogram loaded at any given time. 

4. Any particular COMMON block item should only be 
initialized by one program unit. 



Example: 



I 



BLOCK DATA 
LOGICAL A1 

COMMON/BETA/B (3,3) /GAM/C ( 4 ) 
COMMON /ALPHA/A 1 , C , E , D 
DATA B/1. 1,2. 5, 3. 8, 3*4. 96, 
12*0. 52, 1.1/,C/1.2E0, 3*4.0/ 
DATA Al/.TRUE/,E/-5.6/ 
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APPENDIX A 
Language Extensions and Restrictions 



The FORTRAN-80 language includes the following extensions to 
ANSI Standard FORTRAN (X3. 9-1966). 

1. If c is used in a 'STOP c' or "PAUSE c* statement, 
c may be any six ASCII characters. 

2. Error and End-of-File branches may be specified in 
READ and WRITE statements using the ERR= and END= 
options. 

3. The standard subprograms PEEK, POKE, INP , and OUT 
have been added to the FORTRAN library. 

4. Statement functions may use subscripted variables. 

5. Hexadecimal constants may be used wherever Integer 
constants are normally allowed. 

6. The literal form of Hollerith data (character 
string between apostrophe characters) is permitted 
in place of the standard nH form. 

7. Holleriths and Literals are allowed in expressions 
in place of Integer constants. 

8. There is no restriction to the number of 
continuation lines. 

9. Mixed mode expressions and assignments are allowed, 
and conversions are done automatically. 

FORTRAN-80 places the following restrictions upon Standard 
FORTRAN . 

1. The COMPLEX data type is not implemented. It may 
be included in a future release. 

2. The specification statements must appear in the 
following order: 

1. PROGRAM, SUBROUTINE, FUNCTION, BLOCK DATA 

2. Type, EXTERNAL, DIMENSION 

3 . COMMON 

4. EQUIVALENCE 
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5 . DATA 

6. Statement Functions 



3. A different amount of computer memory is allocated 
for each of the data types: Integer, Real, Double 
Precision, Logical. 

4. The equal sign of a replacement statement and the 
first comma of a DO statement must appear on the 
initial statement line. 

Descriptions of these language extensions and restrictions 
are included at the appropriate points in the text of this 
document. 
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APPENDIX B 
I/O Interface 



Input/Output operations are table-dispatched to the driver 
routine for the proper Logical Unit Number. $LUNTB is the 
dispatch table. It contains one 2-byte driver address for 
each possible LUN. It also has a one-byte entry at the 
beginning, which contains the maximum LUN plus one. The 
initial run-time package provides for 10 LUN's (1 - 10), all 
of which correspond to the TTY. Any of these may be 
redefined by the user, or more added, simply by changing the 
appropriate entries in $LUNTB and adding more drivers. The 
runtime system uses LUN 3 for errors and other user 
communication. Therefore, LUN 3 should correspond to the 
operator console. The initial structure of $LUNTB is shown 
in the listings following this appendix. 

The device drivers also contain local dispatch tables. Note 
that $LUNTB contains one address for each device, yet there 
are really seven possible operations per device: 

1) Formatted Read 

2) Formatted Write 

3) Binary Read 

4) Binary Write 

5) Rewind 

6) Backspace 

7) Endfile 

Each device driver contains up to seven routines. The 
starting addresses of each of these seven routines are 
placed at the beginning of the driver, in the exact order 
listed above. The entry in $LUNTB then points to this local 
table, and the runtime system indexes into it to get the 
address of the appropriate routine to handle the requested 
I/O operation. 

The following conventions apply to the individual I/O 
routines : 

1 . Location $BF contains the data buffer address for 
READS and WRITES. 

2. For a WRITE, the number of bytes to write is in 
location $BL. 

3. For a READ, the number of bytes read should be 
returned in $BL. 
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4. All I/O operations set the condition codes before 
exit to indicate an error condition, end-of-file 
condition, or normal return: 

a) CY=1, Z=don't care - I/O error 

b) CY=0, Z=0 - end-of-file encountered 

c) CY=0, Z=1 - normal return 

The runtime system checks the condition codes after 
calling the driver. If they indicate a non-normal 
condition, control is passed to the label specified 
by "ERR=" or "END=" or, if no label is specified, a 
fatal error results. 

5. $IOERR is a global routine which prints an "ILLEGAL 
I/O OPERATION" message (non-fatal) . This routine 
may be used if there are some operations not 
allowed on a particular device (i.e. Binary I/O on 
a TTY) . 

NOTE 

The I/O buffer has a fixed maximum length 

of 132 bytes unless it is changed at 

• installation time. If a driver allows an 

V input operation to write past the end of 

the buffer, essential runtime variables may 
be affected. The consequences are 
unpredictable . 



The listings following this appendix contain ^n example 
driver for a TTY. REWIND, BACKSPACE, and ENDFILE are 
implemented as No-Ops and Binary I/O as an error. This is 
the TTY driver provided with the runtime package. 



MAC80 1.0 



PAGE 



0000 
0012 
0000 
0000 
0002 
0004 
0006 
0008 
000A 
000C 
000E 

000E 
000E 
000F 
0010 

0010 

0013 

0014 

0017 

001A 

001C 

001E 

0021 

0022 

0025 

0027 

0028 

002B 

002C 

002D 

002E 

002F 

0030 

0033 

0035 

0036 

0037 

0039 

003C 

003F 

0040 

0041 

0042 

0045 



0013 
0042 
0010 
0010 
000E 
000E 
000E 
AF 



C3 0000 * 



AF 

32 0000 

CD 0000 

E6 7F 

FE 0A 

CA 0017 

F5 

2A 0015 

26 00 

EB 

2A 0000 

19 

Fl 

77 

13 

EB 

22 0023 

FE 0D 

C8 

7D 

FE 80 

DA 0017 

CD 0000 

12 

AF 

C9 

3A 0031 

B7 



00100 

00200 

00300 

00400 

00500 

00600 

00700 

00800 

00900 

01000 

01100 

01200 

01300 

01400 

01500 

01600 

01700 

01800 

01900 

02000 

02100 

02200 

02300 

02400 

02500 

02600 

02700 

02800 

02900 

03000 

03100 

03200 

03300 

03400 

03500 

03600 

03700 

03800 

03900 

04000 

04100 

04200 

04300 

04400 

04500 

04600 

04700 

04800 



TTY I/O DRIVER 



EXT 
IRECER EQU 

ENTRY 
$DRV3: DW 
DW 
DW 
DW 
DW 
DW 
DW 
DRV3EN: XRA 

DRV3RE EQU 

DRV3BA EQU 

RET 

DRV3BW: JMP 

DRV3BR EQU 
DRV3FR: XRA 
STA 
DRV31 : CALL 
AN I 
CPI 
JZ 
PUSH 
LHLD 
MVI 
XCHG 
LHLD 
DAD 
POP 
MOV 
INX 
XCHG 
SHLD 
CPI 
RZ 
MOV 
CPI 
JC 
CALL 
DB 
XRA 
RET 
DRV3FW: IDA 
ORA 



SIOERR, 

022 

$DRV3 

DRV3FR 

DRV3FW 

DRV3BR 

DRV3BW 

DRV3RE 

DRV3BA 

DRV3EN 

A 

DRV3EN 
DRV3EN 

$IOERR 

DRV3BW 

A 

$BL 

STTYIN 

0177 

10 

DRV31 

PSW 

$BL 

H,0 

$BF 

D 

PSW 

M,A 

D 

$BL 
015 

A,L 
128 
DR731 

$ERR 

IRECER 

A 

$BL 
A 



$BL , $BF , $ERR , $TTYIN , $TTYOT 
; INPUT RECORD TOO LONG 

; FORMATTED READ 

FORMATTED WRITE 
•BINARY READ 
j BINARY WRITE 
: REWIND 

BACKSPACE 
;ENDFILE ^ „ „„„ 

THESE OPERATIONS ARE 

NO-OPS FOR TTY 



; ILLEGAL OPERATIONS 

■ (PRINT ERROR AND RETURN) 

READ 

ZERO BUFFER LENGTH 
INPUT A CHAR 
AND OFF PARITY 
IGNORE LINE FEEDS 



GET CHAR POSIT IN BUFFER 
ONLY 1 3YTE 

GET BUFFER ADDR 

ADD OFFSET 
GET CHAR 
PUT IT IN BUFFER 
INCREMENT $BL 

SAVE IT 

CR? 

YES— DONE 

SBL 

MAX IS DECIMAL 128 

GET NEXT CHAR 

;INFJT RECORD TOO LONG 

; CLEAR FLAGS 



; BUFFER LENGTH 



i | 
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0046 


C8 


0047 


2A 0029 * 


004A 


3D 


004B 


F5 


004C 


3E 0D 


004E 


CD 0000 * 


0051 


7E 


0052 


FE 2B 


0054 


CA 0079 ' 


0057 


FE 31 


0059 


C2 0064 ■ 


005C 


3E 0C 


00 5E 


CD 004F * 


0061 


C3 0079 ' 


0064 


3E 0A 


0066 


CD 005F * 


0069 


7E 


006A 


FE 20 


006C 


CA 0079 ' 


006F 


FE 30 


0071 


C2 0079 ' 


0074 


3E 0A 


0076 


CD 0067 * 


0079 


Fl 


007A 


23 


0078 


C8 


007C 


F5 


007D 


7E 


007E 


23 


007F 


CD 0077 * 


0082 


Fl 


0083 


3D 


0084 


C3 007B ' 


0087 
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SIOERE 

5'rmN 


0011* SBL 


0018* STTYOT 


DRV3FR 


0013" DRV3FW 


DRV3RE 


000E ' DRV3BA 


DR3FW2 


0079 ' DR3FW1 



PAGE 



04900 
05000 
05100 
05200 
05300 
05400 
05500 
05600 
05700 
05800 
05900 
06000 
06100 
06200 
06300 
06400 
06500 
06600 
06700 
06800 
06900 



07100 
07200 
07300 
07400 
07500 
07600 
07700 
07800 
07900 
08000 
08100 
08200 



PAGE 



RZ 

LHLD 

DCR 

PUSH 

MVT 

CALL 

MOV 

CPI 

JZ 

CPI 

JNZ 

MVI 

CALL 

JMP 

DR3FW1: MVI 
CALL 
MOV 
CPI 
JZ 
CPI 
JNZ 
MVI 
CALL 

DR3FW2: POP 
INX 

DRV32: RZ 

PUSH 

MOV 

INX 

CALL 

POP 

DCR 

JMP 

END 



$BF 

A 

PSW 

A.13 

STTYOT 

A,M 

'+' 
DR3FW2 

'1' 

DR3FW1 
A, 12 
STTYOT 
DR3FW2 
A, 10 

STTYOT 
A,M 



: EMPTY BUFFER 

; BUFFER ADDRESS 

; DECREMENT LENGTH 

;SAVE IT 

;CR 

•OUTPUT IT 

•GET FIRST CHAR IN BUFFER 

;NO LINE FEEDS 

;NOT FORM FEED 
;FORM FEED 
; OUTPUT IT 



;LF 

;GET CHAR BACK 

DR3FW2 ;NO MORE LINE FEEDS 
'0' 

DR3FW2 ;NO MORE LINE FEEDS 

A, 10 ;LF 

STTYOT 

PSW ;GET LENGTH BACK 

H ; INCREMENT PTR 

PSW :SAVE CHAR COUNT 

A.M ;GET NEXT CHAR 

H ; INCREMENT PTR 

STTYOT ; OUTPUT CHAR 

PSW ;GET COUNT 

A ; DECREMENT IT 

DRV32 ;ONE MORE TIME 



0043* 


$BF 


0080* 


IRECER 


0042' 


DRV3BR 


000E' 


DRV3EN 


0064' 


DRV32 



0048* 


$ERR 


003D* 


0012 


SDRV3 


0000' 


0010' 


DRV3BW 


0010' 


000E' 


DRV31 


0017' 


007B' 
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PAGE 


1 










00100 


; COMMENT * 








00200 


a 
f 


DRIVER ADDRESSE 






00210 


/ 






0001 




00220 


LPT 


EQU 


1 


0001 




00230 


DSK 


EQU 


1 


0000 




00235 
00240 
00300 


DTC 
J 


EQU 





0000 




00400 




ENTRY 


SLUNTB 


0000 




00500 




EXT 


SDRV3 


0000 


0B 


00600 


$LUNTB: 


DB 


013 


0001 


0000 * 


00700 




DW 


$DRV3 


0003 




00800 




IFF 


LPT 






00900 




DW 


$DRV3 


0003 




01000 




ENDIF 




0003 




01100 




I FT 


LPT 


0003 




01200 




EXT 


LPTDRV 


0003 


0000 * 


01300 




DW 


LPTDRV 


0005 




01400 




ENDIF 




0005 


0001 * 


01500 




DW 


$DRV3 


0007 




01510 




IFF 


DTC 


0007 


0005 * 


01600 




DW 


$DRV3 


0009 




01602 




ENDIF 




0009 




01604 




I FT 


DTC 






01605 




EXT 


SCMDRV 






01606 




DW 


$CMDRV 


0009 




01608 




ENDIF 




0009 


0007 * 


01700 




DW 


$DRV3 


0003 




01800 




IFF 


DSK 






01900 




DW 


$DRV3 






02000 




DW 


SDRV3 






02100 




DW 


SDRV3 






02200 




DW 


SDRV3 






02300 




DW 


$DRV3 


000B 




02400 




ENDIF 




000B 




02500 




I FT 


DSK 


000B 




02600 




EXT 


DSKDRV 


000B 


0000 * 


02700 




DW 


DSKDRV 


000D 


000B * 


02800 




DW 


DSKDRV 


000F 


000D * 


02900 




DW 


DSKDRV 


0011 


000F * 


03000 




DW 


DSKDRV 


0013 


0011 * 


03100 




DW 


DSKDRV 


0015 




03200 




ENDIF 




0015 




03300 




END 






MAC80 1.0 


PAGE 


2 






LPT 


0001 DSK 


0001 


DTC 


0000 


$LUNTB 


$DRV3 


0009* LPTDRV 


0003* 


DSKDRV 


0013* 





I'S 1 THROUGH 10 

;UNIT 2 IS LPT 

; UNITS 6-10 ARE DSK 

;DTC COMMUNICATIONS UNIT 4 



:MAX LUN + 1 
j THEY ALL POINT TO $DRV3 FOR MOW 



0000' 





MAC80 1.0 


0046 


C8 


0047 


2A 0029 * 


004A 


3D 


004B 


F5 


004C 


3E 0D 


004E 


CD 0000 * 


0051 


7E 


0052 


FE 2B 


0054 


CA 0079 ' 


0057 


FE 31 


0059 


C2 0064 ' 


005C 


3E 0C 


005E 


CD 004F * 


0061 


C3 0079 ' 


0064 


3E 0A 


0066 


CD 005F * 


0069 


7E 


00 6A 


FE 20 


006C 


CA 0079 ' 


006F 


FE 30 


0071 


C2 0079 ' 


0074 


3E 0A 


0076 


CD 0067 * 


0079 


Fl 


007A 


23 


0078 


C8 


007C 


F5 


007D 


7E 


007E 


23 


007F 


CD 0077 * 


0082 


Fl 


0083 


3D ^ , 


0084 


C3 007B ' 


0087 






MAC80 1.0 


SIOERR 
?TTYIN 


0011* $J3L 


0018* STTYOT 


DRV3FR 


0013' DRV3FW 


DRV3RE 


000E' DRV3BA 


DR3FW2 


0079 ' DR3FW1 



PAGE 



04900 

05000 

05100 

05200 

05300 

05400 

05500 

05600 

05700 

05800 

05900 

06000 

06100 

06200 

06300 

06400 

06500 

06600 

06700 

0680W 

06900 

07000 

07100 

07200 

07300 

07400 

07500 

07600 

07700 

07800 

07900 

08000 

08100 

08200 



PAGE 



0043* 
0080* 
0042' 
000E' 
0064' 



RZ 

LHLD 
DCR 
PUSH 
MVT 
CALL 
MOV 
CPI 
JZ 
CPI 
JNZ 
MVI 
CALL 
JMP 
DR3FW1: MVI 
CALL 
MOV 
CPI 
JZ 
CPI 
JNZ 
MVI 
CALL 
DR3FW2: POP 



DRV32 : 



INX 

RZ 

PUSH 

MOV 

INX 

CALL 

POP 

DCR 

JMP 

END 



$BF 

A 

PSW 

A.13 

$TTYOT 

A,M 

'+' 

DR3FW2 

■1' 

DR3FW1 

A,12 

$TTYOT 

DR3FW2 

A, 10 

STTYOT 

A,M 
i i 

DR3FW2 
'0' 

DR3FW2 
A, 10 
STTYOT 
PSW 
H 

PSW 

A,M 

H 

$TTYOT 

PSW 

A 

DRV32 



; EMPTY BUFFER 
BUFFER ADDRESS 
;DECREMENT LENGTH 
;SAVE IT 
;CR 

•OUTPUT IT 
';GET FIRST CHAR IN BUFFER 

;NO LINE FEEDS 

;NOT FORM FEED 
;FORM FEED 
; OUTPUT IT 

;LF 

;GET CHAR BACK 

;NO MORE LINE FEEDS 

;NO MORE LINE FEEDS 
;LF 

;GET LENGTH BACK 
•INCREMENT PTR 

;SAVE CHAR COUNT 
;GET NEXT CHAR 
; INCREMENT PTR 
; OUTPUT CHAR 
;GET COUNT 
; DECREMENT IT 
;ONE MORE TIME 



$BF 

IRECER 

DRV3BR 

DRV3EN 

DRV32 



0048* 


$ERR 


003D* 


0012 


$DRV3 


0000' 


0010' 


DRV3BW 


0010' 


000E' 


DRV31 


0017' 


007B' 
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APPENDIX C 



Subprogram Linkages 



This appendix defines a normal subprogram call as generated 
by the FORTRAN compiler. It is included to facilitate 
linkages between FORTRAN programs and those written in other 
languages, such as 8080 Assembly. 

A subprogram reference with no parameters generates a simple 
"CALL" instruction. The corresponding subprogram should 
return via a simple "RET." (CALL and RET are 8080 opcodes - 
see the assembly manual or 80 80 reference manual for 
explanations. ) 

A subprogram reference with parameters results in a somewhat 
more complex calling sequence. Parameters are always passed 
by reference (i.e., the thing passed is actually the address 
of the low byte of the actual argument). Therefore, 
parameters always occupy two bytes each, regardless of type. 

The method of passing the parameters depends upon the number 
of parameters to pass: 

1. If the number of parameters is less than or equal 
to 3, they are passed in the registers. Parameter 
1 will be in HL, 2 in DE (if present), and 3 in BC 
(if present) . 

2. If the number of parameters is greater than 3, they 
are passed as follows: 

1. Parameter 1 in HL. 

2. Parameter 2 in DE. 

3. Parameters 3 through n in a contiguous data 
block. BC will point to the low byte of this 
data block (i.e., to the low byte of parameter 
3). 

Note that, with this scheme, the subprogram must know how 
many parameters to expect in order to find them. 
Conversely, the calling program is responsible for passing 
the correct number of parameters. Neither the compiler nor 
the runtime system checks for the correct number of 
parameters. 

If the subprogram expects more than 3 parameters, and needs 
to transfer them to a local data area, there is a system 
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subroutine which will perform this transfer. This argument 
transfer routine is named $AT, and is called with HL 
pointing to the local data area, BC pointing to the third 
parameter, and A containing the number of arguments to 
transfer (i.e., the total number of arguments minus 2). The 
subprogram is responsible for saving the first two 
parameters before calling $AT. For example, if a subprogram 
expects 5 parameters, it should look like: 



SUBR: 



SHLD 


P1 


XCHG 




SHLD 


P2 


MVI 


A, 3 


LXI 


H,P3 


CALL 


$AT 



;SAVE PARAMETER 1 

SAVE PARAMETER 2 

NO. OF PARAMETERS LEFT 

POINTER TO LOCAL AREA 

TRANSFER THE OTHER 3 PARAMETERS 



[Body of subprogram] 





RET 




P1 : 


DS 


2 


P2: 


DS 


2 


P3: 


DS 


6 



RETURN TO CALLER 

SPACE FOR PARAMETER 1 

SPACE FOR PARAMETER 2 

SPACE FOR PARAMETERS 3-5 



When accessing parameters in a subprogram, don't forget that 
they are pointers to the actual arguments passed. 



NOTE 

It is entirely up to the 
programmer to see to it that 
the arguments in the calling 
program match in number , type , 
and length with the parameters 
expected "by the subprogram. 
This applies to FORTRAN 
subprograms, as well as those 
written in assembly language. 



FORTRAN Functions 



(Section 9) return their values _ in 
registers or memory depending upon the type. Logical 
results are returned in (A) , Integers in (HL) , Reals in 
memory at $AC , Double Precision in memory at $DAC. ?AC and 
$DAC are the addresses of the low bytes of the mantissas. 
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APPENDIX D 
ASCII CHARACTER CODES 



( 



DECIMAL 


CHAR. 


DECIMAL 


C 


000 


NUL 


043 


+ 


001 


SOH 


044 


/ 


002 


STX 


045 


- 


003 


ETX 


046 


* 


004 


EOT 


047 


/ 


005 


ENQ 


048 





006 


ACK 


049 


1 


007 


BEL 


050 


2 


008 


BS 


051 


3 


009 


HT 


052 


4 


010 


LF 


053 


5 


011 


VT 


054 


6 


012 


FF 


055 


7 


013 


CR 


056 


8 


014 


SO 


057 


9 


015 


SI 


058 


J 


016 


DLE 


059 


7 


017 


DC1 


060 


< 


018 


DC 2 


061 


= 


019 


DC 3 


062 


> 


020 


DC 4 


063 


? 


021 


NAK 


064 


@ 


022 


SYN 


065 


A 


023 


ETB 


066 


B 


024 


CAN 


067 


C 


025 


EM 


068 


D 


026 


SUB 


069 


E 


027 


ESCAPE 


070 


F 


028 


FS 


071 


G 


029 


GS 


072 


H 


030 


RS 


073 


I 


031 


US 


074 


J 


032 


SPACE 


075 


K 


033 


i 


076 


L 


034 


ii 


077 


M 


035 


# 


078 


N 


036 


$ 


079 





037 


% 


080 


P 


038 


& 


081 


Q 


039 


i 


082 


R 


040 


( 


083 


S 


041 


) 


084 


T 


042 


* 


085 


U 



CHAR. 



DECIMAL CHAR. 



LF=Line Feed FF=Form Feed CR=Carrxage Return 



086 


V 


087 


w 


088 


X 


089 


Y 


090 


Z 


091 


[ 


092 


\ 


093 


] 


094 


A (ort) 


095 


< (or «~) 


096 


i 


097 


a 


098 


b 


099 


c 


100 


d 


101 


e 


102 


f 


103 


g 


104 


h 


105 


i 


106 


J 


107 


k 


108 


1 


109 


m 


1 10 


n 


1 1 1 


o 


1 12 


P 


1 13 


q 


1 14 


r 


115 


s 


116 


t 


1 17 


u 


118 


V 


119 


w 


120 


X 


121 


y 


122 


z 


123 


{ 


124 


1 


125 


} 


126 


1 


127 


DEL 


eturn 


DEL=Rubout 
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APPENDIX E 
FORTRAN-80 Library Subroutines 



Th e POHTRAN-80 library ^contains a „u£ ,er ? J ^routines^that 
may be referenced by the user rroiu r th 

program. In ^e following descrxptxon JAC^J" by^of 
floating accumulator; $AC is the addr ent . $DAC 

th ? "! n tr^he dSub^E PREcIsiSn accumulator; $DACis the 
address o? the e iow° U byte of the mantissa. $DAC + 7 is the 
address of the DOUBLE PRECISION exponent. 

All arithmetic routines (action. ^'Jf 1 ^ 
multiplication, division, exponentiation) adhere 
following calling conventions. 

1. Argument 1 is passed in the registers: 
Integer in [HL] 
Real in $AC 
Double in $DAC 

2 Argument 2 is passed either in registers, or in 
memory depending upon the type: 

a. Integers are passed in [HL] , or [DE] if 
[HL] contains Argument 1. 

b. Real and Double Precision values are 
passed in memory pointed to by I Hi.] . 

([HL] points to the low byte of the 
mantissa. ) 



* I 
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The following arithmetic routines are contained in the 
Library s 



Function 


Name 


Argument 1 Type 


Argument 2 Type 


Addition 


$AA 


Real 


Integer 




$AB 


Real 


Real 




$AQ 


Double 


Integer 




$AR 


Double 


Real 




$AU 


Double 


Double 


Division 


$D9 


Integer 


Integer 




$DA 


Real 


Integer 




$DB 


Real 


Real 




$DQ 


Double 


Integer 




$DR 


Double 


Real 




$DU 


Double 


Double 


Exponentiation 


$E9 


Integer 


Integer 




$EA 


Real 


Integer 




$EB 


Real 


Real 




$EQ 


Double 


Integer 




$ER 


Double 


Real 




$EU 


Double 


Double 


Multiplication 


$M9 


Integer 


Integer 




$MA 


Real 


Integer 




$MB 


Real 


Real 




$MQ 


Double 


Integer 




$MR 


Double 


Real 




$MU 


Double 


Double 


Subtraction 


$SA 


Real 


Integer 




$SB 


Real 


Real 




$SQ 


Double 


Integer 




$SR 


Double 


Real 




$SU 


Double 


Double 
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Additional Library routines are ^f^l^TtTlll 
turned iT^lTon^AirTolti^ in 'the" appropriate 
registers : 

Logical in [A] 

Integer in [HL] 

Real in $AC 

Double in $DAC 



Name 


Function 


$CA 


Integer to Real 


$CC 


Integer to Double 


$CH 


Real to Integer 


$CJ 


Real to Logical 


$CK 


Real to Double 


$CX 


Double to Integer 


$CY 


Double to Real 


$cz 


Double to Logical 
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Arithmetic Expression 
Arithmetic IF . . . , 
Arithmetic Operators , 

I\jCx.Q.y « • • e e e c 



25-26, 47 

44, 47, 49 

8 

14, 20, 34-35, 37-38, 40-41, 

56, 79, 89-90, 94-95 



Array Declarator 


e 


. 














o 


20 








Array Element 


■a 




















14, 


20, 


27, 32, 


39 


ASCII Character Codes 











« 


104 








ASSIGN 


• 




















44, 


46 






Assigned GOTO 


• 








• 





• 





44- 


45 






BACKSPACE . . . 







O 





. 







60 








BLOCK DATA . . . 








o 


B 


• 





• 


34, 


37, 


92, 96 




Lk-aXXJ i-l 000000 


e 



















44, 


53, 


92 




Character Set 


e 


e 
















7 








Characteristic . 


• 








O 










23 








Comment Line . . 











„ 










9 








COMMON ..... 






















34, 


37, 


39-41, 


89, 91, 96 


Computed GOTO 


* 



















44- 


45 






Constant .... 






















14- 


15 






Continuation . . 


B 



















9, 


12 






CONTINUE .... 


« 


« 
















44, 


51 






Control Statements 








• 











44 








Us\ In « o e • • • 















O 


34, 


41, 


89, 91, 


96 


Data Representation 








. 








14 

























21 








DECODE 











• 





O 





61 








DIMENSION . . . 


o 















20, 


34, 


37, 96 




Disk Files . . . 




















. 


59 
























44, 


47- 


49 




DO Implied List 























63 








Double precision 























14 








Dummy 


O 





• 








• 





91- 


93, 


95 




ENCODE 


• 

















m 


61 








END ...... 























53, 


89, 


92, 96 




END Line .... 


















11 








ENDFILE .... 











• 











60 








EQUIVALENCE . . 











• 











34, 


39- 


41, 89, 


91, 96 


Executable ... 








ft 














13, 


34, 


44 




Expression . . . 























25- 


26, 


31-32 




Extended Range . 


m 




















50 
























34, 


37, 


90, 93 




External Functions 














87 









Field Descriptors 

FORMAT , 

Formatted READ . , 



65 

55-57, 65, 69, 71-75, 77-80 

54 



Formatted WRITE 
FUNCTION . . . . 

GOTO • « • . • < 

Hexadecimal . , 
Hollerith . . 



57 

34, 37, 82, 88-95 

44, 49 

8, 21, 31, 42 

9, 15, 20-21, 31, 42, 56, 
71-72, 90 



I/O . 54, 100 

I/O List 62 

IF 44, 47 

Index 49 

Initial Line 11 

INP ......85 

Integer 14, 19, 23 

Intrinsic Functions 86 

Label 9, 12, 44-45, 48 

Library Function . 82, 84 

Library Subroutines 105 

Line Format ....9 

List Item 62 Qn 

Literal 9, 20-21, 31, 42, 72, 90 

Logical 14, 19, 23, 73 

Logical Expression 27, 30, 4b 

Logical IF 44, 47, 49 

Logical Operator 28 

Logical Unit Number 54, 58, 100 

LUN 54, 58, 100 

Mantissa 23 

Nested 51 

Non-executable ........ 1 3, 34 

Numeric Conversions 66 

Operand 25 

Operator 25 

OUT 85 

PAUSE 44, 49, 52 

PEEK 85 

POKE 8 ^ 

PROGRAM 34, 83, 92 

^e 49 78 _ 80 

READ in oo 

Real 14, 19, 23 

Relational Expression .... 27 

Relational Operator 27 

Replacement Statement . . . . 32, 48 

RETURN 44 ' 4y ' DJ ' ' 

REWIND 60 

Scale Factor 74-75 

Specification Statement ... 34 
Statement Function 34, 82-83 



O X \J sf aaeooaee 

Storage . . . . „ . 
Storage Format . . . 
Storage Unit .... 
Subprogram ..... 
SUBROUTINE ..... 

Subscript 

Subscript Expression 

■lype ........ 

Type Statement . . . 

Unconditional GOTO . 
Unformatted I/O . . 

Variable 14, 19, 32, 38, 90 

WRITE 57-58, 65, 74, 78-80 



* « a 



a 


44, 


49, 


52 




a 


35 








« 


14 








e 


21, 


23, 


39 




• 


37, 


53, 


82, 


88-96, 102 


e 


34, 


37, 


53, 


82, 89-94 


a 


20, 


27 






e 


21, 


27 






e 


96 








e 

• 
a 


35 

44 
58 









